# Find a company

Canonical documentation: https://veripoint.ai/api-docs/kyb-search

Resolve the legal entity before requesting officers, ownership or financial records.

## Request

POST https://api.globaldatabase.com/v2/kyb/search

This data API uses separately licensed credentials: Authorization: Token YOUR_DATA_API_KEY. It does not accept a Veripoint workspace key.

| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| location | body | string | Yes | ISO country code (GB), country-state code (US-CA, CA-ON, CN-BJ), or a KYB nomenclature ID. |
| name | body | string | No | Company name. Supply at least one company identifier. |
| registration_number | body | string | No | Company registration number; preserve leading zeros. |
| vat_number | body | string | No | VAT number or EIN. |
| ticker | body | string | No | Ticker. Listed in the parameter table and validation list; a later validation note omits it. |
| city_or_state | body | string[] | No | Optional city or state names, for example ["London"]. |
| include_provenance | body | boolean | No | Include source metadata. Some endpoints also change their response structure. |

## Example

```curl
curl --fail-with-body --request POST 'https://api.globaldatabase.com/v2/kyb/search' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Example Limited",
  "location": "GB"
}'
```

## Illustrative response

```json
[
  {
    "id": "12345678",
    "name": "EXAMPLE LIMITED",
    "registration_number": "01234567",
    "country_code": "GB"
  }
]
```

Illustrative default response excerpt: an array of matches. Match the entity before reusing its id.

- location and at least one identifier are required. Use name, registration_number or vat_number for the clearest documented path; confirm ticker-only validation if needed.
- include_provenance adds source metadata. IDs appear as both strings and numbers in the reference examples; preserve them without treating them as registration numbers.

Machine-readable reference: https://veripoint.ai/data-openapi.json