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

Full company report

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

GET/kyb/{id}/fullOfficial reference

Parameters

idpath · integerRequired

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

include_provenancequery · booleanOptional

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

Working with this response

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

Response

200 · application/json

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

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