# Search officer appointments

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

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

## Request

POST https://api.globaldatabase.com/v2/kyb/officers/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 |
|---|---|---|---|---|
| name | body | string | Yes | Full or partial name; minimum 2 characters. |
| date_of_birth_year | body | integer | No | Four-digit year to help distinguish namesakes. |
| country_code | body | string | No | ISO two-letter country code. |
| status | body | "C" \| "P" | No | C for current, P for previous appointments. |
| appointment_date | body | object | No | Object with optional gte and lte dates in YYYY-MM-DD format. |
| resignation_date | body | object | No | Object with optional gte and lte dates in YYYY-MM-DD format. |
| company_name | body | string | No | Filter the linked company name. |
| company_reg_number | body | string | No | Filter the linked registration number. |
| company_status | body | array | No | Company Status nomenclature IDs. |
| company_countries | body | array | No | KYB Countries nomenclature IDs; not the ISO-code filter used by shareholder search. |
| 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/officers/search' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Alex Example",
  "country_code": "GB",
  "status": "C"
}'
```

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

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

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

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