# Company House Document

`GET /company_house_document/{documentId}`

- Live: `GET https://gdapi.globaldata.net.au/api/v2/company_house_document/{documentId}`
- Sandbox: `GET 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.

## Parameters

| Name | In | Type | Description |
|------|----|------|-------------|
| `documentId` | path | string | **Required.** The unique document ID from Companies House filing history. Example: `DOC123456789` |

## Responses

### 200 Document retrieved successfully.

Content type: `application/pdf`

Binary PDF file

### 415 The requested document is not available in PDF format.

Content type: `application/json`

| Field | Type | Description |
|-------|------|-------------|
| `message` | string | Error message indicating the document format is not supported. Example: `Document media type is not supported` |

**Sample response**

```json
{
    "message": "Document media type is not supported"
}
```

Standard error responses: 400, 401, 402, 403, 429, 5XX (see [Common error responses](/docs/reference/general/common-error-responses.md))