/charges

GET 1 credit

Coverage Charges registered at Companies House across all UK jurisdictions, outstanding and satisfied. Companies with nothing registered return no_data.

Returns the charges registered against the company: what was secured, who holds the security, when it was created and whether it is still outstanding. Charges are the cheapest read on whether a company is lent against, and by whom — a debenture in favour of a clearing bank tells a different story from an invoice-discounting facility.

Input

Parameter	Description	Required
`key`	Your API key. May also be sent as a bearer token or X-API-Key header.	Required
`company_number`	Companies House company number, with or without the UK- prefix. E.g. 00000042 or UK-00000042.	Required

Example request

GET request

https://api.ukdatalayer.com/v1/charges?key=YOUR_KEY&company_number=00000042

Output

Field	Type	Description
`charges_count`	number	Total charges on record.
`outstanding_count`	number	Charges still outstanding.
`satisfied_count`	number	Charges recorded as satisfied.
`charges[].charge_id`	string \| null	Companies House charge identifier.
`charges[].charge_number`	number \| null	Sequence number of the charge for this company.
`charges[].status`	string \| null	outstanding, fully-satisfied or part-satisfied.
`charges[].created_on`	date \| null	Date the charge was created.
`charges[].delivered_on`	date \| null	Date it was delivered to Companies House.
`charges[].satisfied_on`	date \| null	Date it was satisfied, where recorded.
`charges[].classification`	string \| null	What kind of instrument it is, e.g. "Account security agreement".
`charges[].particulars`	string \| null	Short particulars of the property or assets charged, as filed.
`charges[].amount_secured`	string \| null	Amount secured, as stated on the filing. Free text — often a formula rather than a figure.
`charges[].persons_entitled`	string[]	The lenders or trustees entitled to the charge.

Example response

200 OK · application/json

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "charges_count": 1,
    "outstanding_count": 1,
    "satisfied_count": 0,
    "charges": [
      {
        "charge_id": "sandbox-charge-1",
        "charge_number": 1,
        "status": "outstanding",
        "created_on": "2024-02-14",
        "delivered_on": "2024-02-21",
        "satisfied_on": null,
        "classification": "Debenture",
        "particulars": "Fixed and floating charge over all present and future assets of the company.",
        "amount_secured": "All monies due or to become due from the company to the chargee",
        "persons_entitled": ["Harbourline Commercial Finance Limited"]
      }
    ]
  }
}

Notes

Charges are returned newest first by creation date.
amount_secured is reproduced as filed. Most filings state a formula ("all monies due…") rather than a number, so treat it as text, not a figure.
The same data is available inline on /company with ?include=charges.