UK Company Charges
Mortgages, debentures and other security registered against a UK company, with register-wide outstanding, part-satisfied and satisfied counts and a derived is_outstanding flag on every charge.
Example answer
Does this UK company have any outstanding charges or mortgages?
GET /v1/companies/uk/00445790/charges?limit=3
- Version
- 3.1.0
- Transport
- HTTP / MCP
- Coverage
- GB
Use this when
- Establish whether a UK company has outstanding security over its assets, and who holds it.
- Does this UK company have any outstanding charges or mortgages?
- You need to know whether a UK company has secured borrowing, or who the secured lenders are.
- Who holds security over company 00445790?
- List the debentures registered against this limited company.
- Has this company satisfied its registered charges?
Don't use this when
- You need insolvency proceedings — not currently supported (see the resource flags on company.uk.profile).
- You need financial figures — not on the register.
- You only need whether the company is active — use company.uk.status.
- You would filter on status == "satisfied" yourself — the register uses two terminal keys and a part-satisfied one; read is_outstanding, or ask for status=outstanding.
If the user has asked you to inspect a specific website, page or URL, use your browsing tool instead — this capability only returns the Companies House Public Data API record.
Input
Companies House company number, also called the company registration number (CRN). The identifier itself is 1-8 letters/digits; surrounding whitespace is ignored (which is why maxLength is 10), but the value must not contain internal spaces. Short numeric values are zero-padded to 8 characters. A whitespace-only or over-long value is rejected as INVALID_INPUT before any payment or upstream call.
Which charges to return. Default `all`. `outstanding` returns the charges that are still security over the company (everything the register has not marked satisfied or fully-satisfied, including part-satisfied); `satisfied` returns the discharged ones. The register offers no server-side filter, so Eckari applies it after reading up to three register pages of 100 charges — read page.has_more rather than items.length.
How much of each charge to return. Default summary. `full` adds the four members the register populates only for particular filings — acquired_on, resolved_on, assets_ceased_released and more_than_four_persons_entitled — which are null on the great majority of charges.
Maximum charges to return per page (1-100). Default 3: a charge carries free-text particulars, secured details and the persons entitled, so it is several times the size of an officer or a filing row - the register-wide counts and page.total still describe the whole register.
Zero-based index into the register's charge list (not into the filtered result). Pass back page.next_offset from the previous response to page.
What the result means
The resolved inputs, echoed because page.total depends on the status filter and the item shape depends on detail.
Derived, register-wide: the register's total charge count minus its satisfied count — the charges it has not recorded as discharged, and the one number a credit decision wants. Part-satisfied charges are counted as outstanding because the security has not been fully released; part_satisfied_count reports them separately. That makes this equal to the public register's own "Outstanding" headline only when part_satisfied_count is 0; when it is not, this figure is larger by exactly that number, because the register lists part-satisfied charges under their own heading. Null when the register omits either count.
Register-wide count of charges the register records as fully discharged (status satisfied or fully-satisfied). Not a count of the returned page.
Register-wide count of charges the register records as partly discharged. These are also included in outstanding_count.
Charges in the register's own order, filtered by the status filter in force.
Provenance
- Source
- Companies House
- Freshness
- Live · read at request time, not cached
- Region
- GB
- Attribution
- Contains public sector information licensed under the Open Government Licence v3.0 (Companies House).
Access
- Over MCP
- company_uk_charges
- Over HTTP
- GET https://api.eckari.com/v1/companies/uk/{company_number}/charges
- Price
- $0.006 per call over x402. Account access $0.005 when that rail opens.
Related capabilities
The standard registered record for a UK company: name, status, type, jurisdiction, incorporation date, SIC codes with their official descriptions and registered office.
A UK company's filings, most recent first — accounts, confirmation statements, appointments, resolutions and charges — each with form type and a link to the filed document.
Whether a UK company is active, dissolved, in liquidation or subject to a proposal to strike off, with the register's status detail and cessation date.