# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/advanced_search_companies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/get_companies_with_charges_by_lender \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/get_company_charges \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/get_company_filing_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/get_company_officers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-find-and-update-company-information-service-gov-uk-api-b66cbdd7/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","query":"<string>","type":"<string>"}'
```