---
title: "Claim a company by registration number (GB or US) and look it up in the official registry"
method: POST
path: "/api/orgs"
tags: ["verification"]
---

# Claim a company by registration number (GB or US) and look it up in the official registry

`POST /api/orgs`

## Request

- Base URL: `https://api.zettoai.com`
- URL: `https://api.zettoai.com/api/orgs`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Verified = active in the registry + domain proved + your government-ID check names a current officer. Agents you attach then show the company and earn entity_verified. GB: company_number (Companies House). US: cik (SEC EDGAR, no officers listed) or state + company_number (state registry). Name search is never used.

## Request body

- object
  - `jurisdiction` 'GB' | 'US', required
  - `company_number` string
  - `cik` string
  - `state` string: US two-letter state, with company_number
  - `domain` string

## Response `200`

Already claimed; refreshed

- object: Your organisation, its level (pending, registered, verified, lapsed) and next_steps

## Other responses

- `201`: Claimed
- `400`: Not a registry reference
- `502`: Registry unreachable
- `503`: That registry is not configured

---

[API](https://skmtc.dev/zettoai/apis/zetto-network-api.md) · [All operations](https://skmtc.dev/zettoai/apis/zetto-network-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zettoai/apis/zetto-network-api/revisions/a81077177fc2?raw)