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

Company officers

Retrieve available director and officer appointments for one company.

GET/kyb/{id}/officersOfficial reference

Parameters

idpath · integerRequired

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

pagequery · integerOptional

Page to retrieve.

per_pagequery · integerOptional

Records to return per page. No maximum is specified here in the source reference.

include_provenancequery · booleanOptional

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

Working with this response

  • With provenance, officer, appointment and address fields are grouped into nested objects.
  • An officer appointment is not evidence of share ownership or a sanctions-screening result.

Response

200 · application/json

Illustrative default excerpt. This endpoint uses data, total_pages and total_results.

Response JSON
{
  "data": [
    {
      "id": 123,
      "first_name": "Alex",
      "last_name": "Example",
      "appointed_at": "2020-01-01",
      "resigned_at": null,
      "work_status": "ACTIVE",
      "job_title": "Director"
    }
  ],
  "total_pages": 1,
  "total_results": 1
}