KYB / API REFERENCE

Company profile

Retrieve legal identity, status, incorporation, address and available contact information.

GET/kyb/{id}/liteOfficial reference

Parameters

idpath · integerRequired

Company ID returned by a company lookup. It is not the registration number.

include_provenancequery · booleanOptional

Include source metadata. Some endpoints also change their response structure.

Working with this response

With include_provenance=true, the example changes from a flat object to grouped basic, address and contact objects with source metadata. Do not only add a source field to your default-response parser.

Response

200 · application/json

Illustrative default response excerpt. Fields may be null or unavailable.

{
  "id": "12345678",
  "name": "EXAMPLE LIMITED",
  "registration_number": "01234567",
  "country_code": "GB",
  "status": "Active",
  "incorporation_date": "2020-01-01",
  "website": null,
  "ticker": null
}

Request example

curl --fail-with-body --request GET 'https://api.globaldatabase.com/v2/kyb/YOUR_COMPANY_ID/lite' \
  --header "Authorization: Token $GDB_API_KEY" \
  --header 'Accept: application/json'

Set GDB_API_KEY in your server environment. Replace YOUR_COMPANY_ID with the ID returned by your lookup. These examples are not executed by this page.