# Company officers

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

Retrieve available director and officer appointments for one company.

## Request

GET https://api.globaldatabase.com/v2/kyb/{id}/officers

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 |
|---|---|---|---|---|
| id | path | integer | Yes | Company ID returned by a company lookup. It is not the registration number. |
| page | query | integer | No | Page to retrieve. |
| per_page | query | integer | No | Records to return per page. No maximum is specified here in the source reference. |
| include_provenance | query | boolean | No | Include source metadata. Some endpoints also change their response structure. |

## Example

```curl
curl --fail-with-body --request GET 'https://api.globaldatabase.com/v2/kyb/YOUR_COMPANY_ID/officers?page=1&per_page=10' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json'
```

## Illustrative 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
}
```

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

- 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.

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