# Financial statements

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

Pull the actual deterministic financial dataset for a resolved company through the Financial KYB endpoint.

## Request

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

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

## Illustrative response

```json
{
  "years": [
    "2023-12-31"
  ],
  "groups": [
    {
      "id": "Summary",
      "name": "Summary",
      "order": 0,
      "list": [
        {
          "name": "Currency",
          "list": {
            "2023-12-31": "GBP"
          }
        },
        {
          "name": "Working Capital",
          "list": {
            "2023-12-31": "4200000.0"
          }
        }
      ]
    }
  ]
}
```

Illustrative structure and fictional values. Figures may be numeric strings or null; keys correspond to the returned reporting periods.

- This Financial KYB request is the endpoint Veripoint uses to retrieve the financial data after resolving a company ID. The product is documented under Financials API.
- Read the currency, reporting period and consolidated-account context alongside each number. A null value does not mean zero.
- With provenance, the financial shape is preserved and a top-level source object is added.

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