UK Business Check (Bulk)

POST /api/v2/uk_business_checks operationId: uk_business_checks

Live: https://gdapi.globaldata.net.au/api/v2/uk_business_checks · Sandbox: https://sandbox-gdapi.globaldata.net.au/api/v2/uk_business_checks

Checks up to 50 UK companies in a single synchronous request. Each item in requests is looked up exactly as /uk_business_check would, and the results are returned in the same order with the caller's check_id echoed back for correlation.

Per-item errors

A problem with one item does not fail the batch. Items that fail carry an error string and an empty match, and are not billed:

The number is not a valid UK company number. - the number is not 8 alphanumeric characters.
Companies House service is currently unavailable. - Companies House could not be reached for that item.

Items where the number is valid but Companies House holds no record return "match": [] with no error, and are billed as an attempt.

Rate limits

Each item may require up to three Companies House requests. Batches are processed sequentially, so large batches take proportionally longer to respond.

Sandbox Environment

Uses the same deterministic fixture set as /uk_business_check.

Request body

Content type application/json.

Field Description

requestsrequired array of objects [1..50 items]

Field	Description
`requests`required	array of objects [1..50 items]
`requests[].check_id`	string [max 255 characters] Optional caller-supplied identifier, echoed back on the matching result. Example: `entity-uuid-1`
`requests[].number`required	string [max 255 characters] The 8-character UK Companies House company number. Example: `01234567`

requests[].check_id

string [max 255 characters]

Optional caller-supplied identifier, echoed back on the matching result.

Example: entity-uuid-1

requests[].numberrequired

string [max 255 characters]

The 8-character UK Companies House company number.

Example: 01234567

Responses

200

Batch complete. Inspect each result for `error`.

application/json

Field Description

message

string

Example: Ok

api_reference

string (uuid)

Audit reference for this call.

Example: fe4291ca-d831-4760-96df-c9cb03b3cd95

results array of objects

results[].check_id

string or null

Example: entity-uuid-1

results[].error

string

Present only when this item could not be checked.

Example: The number is not a valid UK company number.

results[].match

one of 2 shapes

The matched company, or an empty array [] when not found or on error.

UK Business Check match

Field	Description
`company_number`	string Example: `01234567`
`company_name`	string Example: `ACME TRADING LIMITED`
`company_status`	string Companies House status, e.g. `active`, `dissolved`, `liquidation`, `dormant`. Example: `active`
`company_status_detail`	string or null
`type`	string Companies House company type, e.g. `ltd`, `plc`, `llp`. Example: `ltd`
`jurisdiction`	string or null Example: `england-wales`
`date_of_creation`	string (date) or null Example: `2001-03-14`
`date_of_cessation`	string (date) or null
`registered_office_address`	object
`registered_office_address.address_line_1`	string or null Example: `1 High St`
`registered_office_address.address_line_2`	string or null
`registered_office_address.locality`	string or null Example: `London`
`registered_office_address.region`	string or null
`registered_office_address.postal_code`	string or null Example: `SW1A 1AA`
`registered_office_address.country`	string or null Example: `England`
`previous_company_names`	array of objects
`previous_company_names[].name`	string Example: `ACME LIMITED`
`previous_company_names[].effective_from`	string (date) or null Example: `1998-01-01`
`previous_company_names[].ceased_on`	string (date) or null Example: `2001-03-14`
`sic_codes`	array of strings SIC codes as plain strings.
`officers`	array of objects Officers appointed or resigned within the last 12 months. Long-standing officers with no change in that period are omitted. Active officers are listed first.
`officers[].officer_id`	string or null Companies House officer appointment identifier. Can be passed to `/company_house_officer_report`. Example: `abc123`
`officers[].name`	string Example: `SMITH, John`
`officers[].officer_role`	string Example: `director`
`officers[].appointed_on`	string (date) or null Example: `2020-05-01`
`officers[].resigned_on`	string (date) or null
`filing_history`	array of objects Filings made within the last 12 months, newest first (from the 100 most recent filings on record).
`filing_history[].transaction_id`	string Example: `MzQ1NjAwMQ`
`filing_history[].document_id`	string or null Identifier for `/company_house_document/{documentId}`; null when no document is available. Example: `8j9Kx2`
`filing_history[].date`	string (date) Example: `2026-06-30`
`filing_history[].type`	string Companies House form type, e.g. `AA`, `CS01`, `AP01`. Example: `AA`
`filing_history[].category`	string Example: `accounts`
`filing_history[].description`	string Example: `accounts-with-accounts-type-micro-entity`

Empty array

Returned in place of an empty object for backward compatibility. When the associated object has no data, the API returns an empty array [] instead of an empty object {}. Clients should treat [] as equivalent to {} for these fields. This shape exists for backward compatibility and will not be removed. (array [max 0 items])

Standard error responses: 400 401 402 403 429 5XX See common error responses

Previous UK Business Check

Request body application/json

{
    "requests": [
        {
            "check_id": "entity-uuid-1",
            "number": "01234567"
        }
    ]
}

Response

200 Batch complete. Inspect each result for error.

{
    "message": "Ok",
    "api_reference": "fe4291ca-d831-4760-96df-c9cb03b3cd95",
    "results": [
        {
            "check_id": "entity-uuid-1",
            "error": "The number is not a valid UK company number.",
            "match": {
                "company_number": "01234567",
                "company_name": "ACME TRADING LIMITED",
                "company_status": "active",
                "company_status_detail": null,
                "type": "ltd",
                "jurisdiction": "england-wales",
                "date_of_creation": "2001-03-14",
                "date_of_cessation": null,
                "registered_office_address": {
                    "address_line_1": "1 High St",
                    "address_line_2": null,
                    "locality": "London",
                    "region": null,
                    "postal_code": "SW1A 1AA",
                    "country": "England"
                },
                "previous_company_names": [
                    {
                        "name": "ACME LIMITED",
                        "effective_from": "1998-01-01",
                        "ceased_on": "2001-03-14"
                    }
                ],
                "sic_codes": [
                    "62012",
                    "62020"
                ],
                "officers": [
                    {
                        "officer_id": "abc123",
                        "name": "SMITH, John",
                        "officer_role": "director",
                        "appointed_on": "2020-05-01",
                        "resigned_on": null
                    }
                ],
                "filing_history": [
                    {
                        "transaction_id": "MzQ1NjAwMQ",
                        "document_id": "8j9Kx2",
                        "date": "2026-06-30",
                        "type": "AA",
                        "category": "accounts",
                        "description": "accounts-with-accounts-type-micro-entity"
                    }
                ]
            }
        }
    ]
}

400 Bad or missing input parameter shared error response

{
    "message": "string"
}

401 Unauthorized - The request is not authorized. shared error response

{
    "message": "API Key Inactive"
}

402 Insufficient Credit - Insufficient credit to process this request shared error response

{
    "message": "Insufficient Credit"
}

403 No access - No permission to process this request shared error response

{
    "message": "No access"
}

429 Rate limited - The request rate limit has been reached shared error response

{
    "message": "Rate limited"
}

5XX Internal error - Internal system error shared error response

{
    "message": "Internal error"
}