Skip to API documentation
veripoint
Login Start for free
Developer documentationAPI v2 + MCP
Request developer access
KYB / API REFERENCE

Search officer appointments

Start with an officer’s name and retrieve linked company appointments.

POST/kyb/officers/searchOfficial reference

Parameters

namebody · stringRequired

Full or partial name; minimum 2 characters.

date_of_birth_yearbody · integerOptional

Four-digit year to help distinguish namesakes.

country_codebody · stringOptional

ISO two-letter country code.

statusbody · "C" | "P"Optional

C for current, P for previous appointments.

appointment_datebody · objectOptional

Object with optional gte and lte dates in YYYY-MM-DD format.

resignation_datebody · objectOptional

Object with optional gte and lte dates in YYYY-MM-DD format.

company_namebody · stringOptional

Filter the linked company name.

company_reg_numberbody · stringOptional

Filter the linked registration number.

company_statusbody · arrayOptional

Company Status nomenclature IDs.

company_countriesbody · arrayOptional

KYB Countries nomenclature IDs; not the ISO-code filter used by shareholder search.

include_provenancebody · booleanOptional

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

Working with this response

  • Provenance groups company, officer and appointment information. Use the relevant response variant.

Response

200 · application/json

Illustrative default array excerpt. No pagination parameters are specified for this operation in the source.

Response JSON
[
  {
    "id": 123,
    "company_id": 12345678,
    "company_name": "EXAMPLE LIMITED",
    "full_name": "Alex Example",
    "officer_role": "Director",
    "appointed_at": "2020-01-01",
    "resigned_at": null
  }
]