API error codes

Every error is an RFC 9457 application/problem+json object. Branch on code, show detail to people, and keep request_id for support.

Start free Read the docs

The error envelope is the same on every endpoint. Read the full error contract.

HTTP 400

invalid_parameterA query or body field is missing, malformed, or outside the allowed range.
invalid_identifierThe company number or other identifier does not match the scheme the register uses.
unknown_jurisdictionThe jurisdiction code is not one the API serves.

HTTP 401

HTTP 402

HTTP 404

HTTP 409

officers_not_availableThe register does not publish a structured officer table for this company, so there are no officers to return.

HTTP 413

batch_too_largeA batch request contains more items than the endpoint accepts.

HTTP 422

missing_identifier_or_nameA verify request supplied neither a company_number nor a name.

HTTP 429

rate_limitedThe key exceeded a per-second or per-minute request window.

HTTP 500

internal_errorThe API hit an unexpected error while handling the request.

HTTP 503

Start free with Corpo API

Verify any company from official registers with one API.

Start free Read the docs