# Companies House Register — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and access detailed information about UK companies registered at Companies House, including company profiles, filing histories, officers, and financial charges. Filter companies by name, status, type, SIC code, and more.

**Category:** Government & Public Data | **Website:** [find-and-update.company-information.service.gov.uk/](https://find-and-update.company-information.service.gov.uk/) | **Docs:** [parse.bot/marketplace/b66cbdd7-e6bb-4062-9d38-a0d5c5f0028b/find-and-update-company-information-service-gov-uk-api](https://parse.bot/marketplace/b66cbdd7-e6bb-4062-9d38-a0d5c5f0028b/find-and-update-company-information-service-gov-uk-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Advanced search companies

Advanced company search with multiple filters including name, status, type, SIC codes, and registered office address. All filter parameters are optional but at least one should be provided for meaningful results. Paginates via page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_name_includes` | string | No | Company name must include this text. |
| `company_status` | string | No | Filter by company status (e.g., active, dissolved). |
| `company_type` | string | No | Filter by company type. |
| `page` | integer | No | Page number for pagination. |
| `registered_office_address` | string | No | Filter by registered office address. |
| `sic_codes` | string | No | Filter by SIC code. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/advanced-search-companies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_name_includes":"<string>","company_status":"<string>","company_type":"<string>","page":"<integer>","registered_office_address":"<string>","sic_codes":"<string>"}'
```

### Get companies with charges by lender

Search for companies that have a charge registered by a specific lender. Uses a company search query to identify candidate companies, then inspects their charge records for a matching lender name in the persons_entitled field. Returns details for up to 5 matched companies. An empty matches array is a valid result when no companies in the search results have charges from the specified lender.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lender_name` | string | Yes | Name of the lender to search for in charge records (matched case-insensitively against persons_entitled). |
| `search_query` | string | No | Company search query to find companies to check. Defaults to lender_name if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/get-companies-with-charges-by-lender \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lender_name":"<string>","search_query":"<string>"}'
```

### Get company charges

Get all registered charges (mortgages) for a company including status, dates, persons entitled, and descriptions. Returns all charges in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_number` | string | Yes | Company registration number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/get-company-charges \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_number":"<string>"}'
```

### Get company filing history

Get filing history for a company. Returns paginated list of filings with date, type code, and description. Each page holds up to 25 filings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Filter by filing category. |
| `company_number` | string | Yes | Company registration number. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/get-company-filing-history \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","company_number":"<string>","page":"<integer>"}'
```

### Get company officers

Get list of current officers for a company including their roles, appointment dates, and addresses. Returns all active officers in a single response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_number` | string | Yes | Company registration number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/get-company-officers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_number":"<string>"}'
```

### Get company profile

Get full company profile by company number including name, address, status, type, incorporation date, and SIC codes. Returns a single company record.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company_number` | string | Yes | Company registration number (e.g., 00445790). Leading zeros preserved. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/get-company-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"company_number":"<string>"}'
```

### Search

Search for companies by name, number, or officer name. Returns paginated results mixing company and officer entries. Pagination via page number; each page holds up to 20 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (company name, number, or officer name). |
| `type` | string | No | Search type filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/companies-house-register/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.