Company House Report

POST /api/v2/company_house_report operationId: company_house_report

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

Requests a comprehensive UK Companies House report for the specified company. The response confirms the job was queued and returns an api_reference. Poll GET /company_house_report/{api_reference} until the report payload is ready.

Report Contents

The company report includes:

Company registration details
Registered office address
Current and previous company names
Officers (directors, secretaries)
Persons with significant control (PSCs)
Filing history summary
Accounts information
Charges (if any)

Sandbox Environment

The sandbox dataset is deterministic and does not use live data. Use one of the following sample company numbers to receive predictable reports:

Company Name	Company Number	Status	Notes
TEST COMPANY LTD	12345678	Active	Standard company with 2 officers
SAMPLE HOLDINGS PLC	87654321	Active	PLC with multiple officers including corporate secretary
DORMANT SERVICES LTD	11223344	Dormant	Dormant company
DISSOLVED EXAMPLE LTD	99887766	Dissolved	Dissolved company with previous names
SCOTTISH ENTERPRISE SC	SC654321	Active	Scottish company
DELAYED REPORT LTD	55667788	Active	Returns 202 on first poll (simulates async processing)

Request body

Content type application/json. The company number to generate a report for.

Field Description

Field	Description
`company_number`required	string [8..8 characters] The unique 8-character UK Companies House company number. Example: `12345678`

company_numberrequired

string [8..8 characters]

The unique 8-character UK Companies House company number.

Example: 12345678

Responses

200

Report request accepted.

application/json

Field Description

Field	Description
`message`	string Always `Ok` on success. Example: `Ok`
`function`	string The API function that handled the request. Example: `company_house_report`
`api_reference`	string (uuid) Audit reference for this report request. Poll `/company_house_report/{api_reference}` to retrieve results. Example: `fe4291ca-d831-4760-96df-c9cb03b3cd95`

message

string

Always Ok on success.

Example: Ok

function

string

The API function that handled the request.

Example: company_house_report

api_reference

string (uuid)

Audit reference for this report request. Poll /company_house_report/{api_reference} to retrieve results.

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

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

Previous Company House Search Next Retrieve Company House Report

Request body application/json

{
    "company_number": "12345678"
}

Response

200 Report request accepted.

{
    "message": "Ok",
    "function": "company_house_report",
    "api_reference": "fe4291ca-d831-4760-96df-c9cb03b3cd95"
}

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