# Company House Report

`POST /company_house_report`

- Live: `POST https://gdapi.globaldata.net.au/api/v2/company_house_report`
- Sandbox: `POST 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

The company number to generate a report for.

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

**Sample request**

```json
{
    "company_number": "12345678"
}
```

## Responses

### 200 Report request accepted.

Content type: `application/json`

| Field | Type | 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` |

**Sample response**

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

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