# Full company report

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

Request profile, officers, shareholders, group structure and financials in one response.

## Request

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

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. |
| 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/full' \
  --header "Authorization: Token $DATA_API_KEY" \
  --header 'Accept: application/json'
```

## Illustrative response

```json
{
  "lite": {
    "id": "12345678",
    "name": "EXAMPLE LIMITED",
    "registration_number": "01234567",
    "country_code": "GB"
  },
  "officers": [],
  "shareholders": [],
  "group_structures_full": [],
  "financial": {
    "error": {
      "status_code": 403,
      "detail": {
        "message_guard": "Example: financial access is not enabled."
      }
    }
  }
}
```

Illustrative partial-response excerpt. HTTP 200 does not guarantee that every section succeeded.

- Inspect lite, officers, shareholders, group_structures_full and financial individually for error before reading data.
- Each section has its own entitlement and usage accounting. Section errors can contain status_code 403 for access/limit issues or 404 for unavailable data.
- Officers and shareholders are complete sets in this response, unlike their paginated standalone operations.
- Do not assume bundled group_structures_full is identical to the standalone tree endpoint; the source examples use different structures.

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