Company House Document
/api/v2/company_house_document/{documentId}
operationId: company_house_document
Live: https://gdapi.globaldata.net.au/api/v2/company_house_document/{documentId} · Sandbox: https://sandbox-gdapi.globaldata.net.au/api/v2/company_house_document/{documentId}
Retrieves a document from UK Companies House by its document ID. Documents are typically annual accounts, confirmation statements, or other filings associated with a company.
Document Types
Common document types include:
| Document Type | Description |
|---|---|
| Annual Accounts | Financial statements filed annually |
| Confirmation Statement | Annual statement confirming company details |
| Articles of Association | Company constitution document |
| Certificate of Incorporation | Original registration certificate |
| Memorandum of Association | Founding document for older companies |
| Change of Director | Notification of officer changes |
Response Format
This endpoint returns the document as a PDF file (application/pdf). If the requested document is not available in PDF format, a 415 Unsupported Media Type error is returned.
Sandbox Environment
The sandbox dataset is deterministic and does not use live data. Use document IDs with the sandbox-document- prefix to receive a placeholder PDF document.
| Document ID | Description |
|---|---|
| sandbox-document-accounts-2023 | Sample annual accounts document |
| sandbox-document-confirmation | Sample confirmation statement |
| sandbox-document-incorporation | Sample certificate of incorporation |
Any document ID starting with sandbox-document- will return a valid placeholder PDF. Document IDs not matching this format will return a 400 error in the sandbox environment.
Path parameters
| Field | Description |
|---|---|
documentIdrequired |
string The unique document ID from Companies House filing history. |
Responses
Document retrieved successfully.
application/pdf
Binary PDF file
The requested document is not available in PDF format.
application/json
| Field | Description |
|---|---|
message |
string Error message indicating the document format is not supported. |