# Uk Company Charges Lookup (`devon_gtme/uk-company-charges-lookup`) Actor

Bulk-lookup secured lending (mortgages, debentures, fixed & floating charges) for any list of UK company numbers from Companies House. Get each company's charge history: lender, type, amount, dates and satisfied status. For credit risk, asset finance and due diligence. Free official CH API.

- **URL**: https://apify.com/devon\_gtme/uk-company-charges-lookup.md
- **Developed by:** [Devon Kellar](https://apify.com/devon_gtme) (community)
- **Categories:** Developer tools, Automation
- **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## UK Company Charges Lookup — Secured Lending History

Bulk-lookup **secured lending** (mortgages, debentures, fixed & floating charges) for any list of UK company numbers, straight from the official Companies House register. Feed in numbers from your own list, a CRM export, or the output of our [New Incorporations](https://apify.com/devon_gtme/uk-new-company-incorporations) or [Strike-Off Monitor](https://apify.com/devon_gtme/uk-company-strike-off-dissolution-monitor) actors — this one enriches them with borrowing history.

### Why this matters

A company's charges register tells you who's already lent it money and how exposed it is:

- **Credit risk & due diligence teams** — see existing secured lenders before extending credit yourself
- **Asset finance & invoice finance brokers** — spot companies with maxed-out or specific charge types
- **M&A / acquisition due diligence** — undisclosed charges are a classic deal-breaker to catch early
- **Insolvency practitioners** — understand the security waterfall before a case even opens
- **Competitors sizing up a target** — a company's borrowing pattern says a lot about its growth stage

### What you get

Each charge record includes:

| Field | Example |
|---|---|
| `companyNumber` | NI603481 |
| `chargeType` | Second mortgage debenture |
| `status` | outstanding |
| `createdOn` | 2011-01-21 |
| `deliveredOn` | 2011-02-10 |
| `personsEntitled` | The lender/chargee name |
| `particulars` | Full description of what's secured |
| `chargeUrl` | Direct link to the official filing |

### Setup — free API key (2 minutes)

Uses the **official Companies House API**, free:

1. Register at [developer.company-information.service.gov.uk](https://developer.company-information.service.gov.uk/)
2. Create an application → copy the **REST API key**
3. Paste it into the actor's **API Key** input (stored encrypted)

### A note on scope

Companies House does **not** provide a way to search for "all charges filed this week" across every company — charges are only queryable per-company. This actor is a **lookup/enrichment tool**, not a new-charges trigger monitor: you supply the company numbers, it returns their charge history. To find companies worth checking in the first place, pair it with our [New Incorporations](https://apify.com/devon_gtme/uk-new-company-incorporations) or [Strike-Off Monitor](https://apify.com/devon_gtme/uk-company-strike-off-dissolution-monitor) actors, or your own prospect/customer list.

### Typical usage

- **Due diligence on a prospect list:** paste your target companies' numbers, leave `onlyOutstanding` on to see current exposure only
- **Full history audit:** turn `onlyOutstanding` off to include satisfied (repaid) charges too
- **Chain with another actor:** export company numbers from a CH search actor, feed them straight in here

### Export & integrations

Results land in an Apify dataset — export **CSV, Excel, JSON**, or connect Google Sheets, Make, Zapier, and webhooks via Apify integrations.

### Data source & fair use

Data comes from the official Companies House API and is Crown copyright, available for reuse under the [Companies House policy](https://www.gov.uk/government/organisations/companies-house). This actor is not affiliated with Companies House.

---

**Need something more custom?** Automated charges monitoring on your existing customer/prospect base, credit risk scoring, or a fully managed pipeline — message me via my Apify profile and I'll build it.

# Actor input Schema

## `apiKey` (type: `string`):

Your free Companies House API key. Create one in 2 minutes at https://developer.company-information.service.gov.uk/ — register, create an application, copy the REST API key.
## `companyNumbers` (type: `array`):

UK company registration numbers to look up, e.g. '13321445' or 'NI603481'. Paste any list — from a CRM export, spreadsheet, or the output of another actor like our New Incorporations or Strike-Off Monitor.
## `onlyOutstanding` (type: `boolean`):

Skip fully-satisfied (repaid) charges — only return charges the company is still liable under. Turn off to see full history including satisfied charges.
## `skipCompaniesWithNoCharges` (type: `boolean`):

When on, companies with zero matching charges are omitted from the output entirely instead of appearing as a 'no charges found' row.

## Actor input object example

```json
{
  "companyNumbers": [],
  "onlyOutstanding": true,
  "skipCompaniesWithNoCharges": true
}
````

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companyNumbers": [],
    "onlyOutstanding": true,
    "skipCompaniesWithNoCharges": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("devon_gtme/uk-company-charges-lookup").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "companyNumbers": [],
    "onlyOutstanding": True,
    "skipCompaniesWithNoCharges": True,
}

# Run the Actor and wait for it to finish
run = client.actor("devon_gtme/uk-company-charges-lookup").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companyNumbers": [],
  "onlyOutstanding": true,
  "skipCompaniesWithNoCharges": true
}' |
apify call devon_gtme/uk-company-charges-lookup --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=devon_gtme/uk-company-charges-lookup",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Uk Company Charges Lookup",
        "description": "Bulk-lookup secured lending (mortgages, debentures, fixed & floating charges) for any list of UK company numbers from Companies House. Get each company's charge history: lender, type, amount, dates and satisfied status. For credit risk, asset finance and due diligence. Free official CH API.",
        "version": "0.1",
        "x-build-id": "kEh2xNCeL0BTpKhM1"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/devon_gtme~uk-company-charges-lookup/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-devon_gtme-uk-company-charges-lookup",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/devon_gtme~uk-company-charges-lookup/runs": {
            "post": {
                "operationId": "runs-sync-devon_gtme-uk-company-charges-lookup",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/devon_gtme~uk-company-charges-lookup/run-sync": {
            "post": {
                "operationId": "run-sync-devon_gtme-uk-company-charges-lookup",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "apiKey",
                    "companyNumbers"
                ],
                "properties": {
                    "apiKey": {
                        "title": "Companies House API Key",
                        "type": "string",
                        "description": "Your free Companies House API key. Create one in 2 minutes at https://developer.company-information.service.gov.uk/ — register, create an application, copy the REST API key."
                    },
                    "companyNumbers": {
                        "title": "Company Numbers",
                        "type": "array",
                        "description": "UK company registration numbers to look up, e.g. '13321445' or 'NI603481'. Paste any list — from a CRM export, spreadsheet, or the output of another actor like our New Incorporations or Strike-Off Monitor.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "onlyOutstanding": {
                        "title": "Only Outstanding Charges",
                        "type": "boolean",
                        "description": "Skip fully-satisfied (repaid) charges — only return charges the company is still liable under. Turn off to see full history including satisfied charges.",
                        "default": true
                    },
                    "skipCompaniesWithNoCharges": {
                        "title": "Skip Companies With No Charges",
                        "type": "boolean",
                        "description": "When on, companies with zero matching charges are omitted from the output entirely instead of appearing as a 'no charges found' row.",
                        "default": true
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```