/company-filings

GET 1 request = 1 credit

Coverage All UK jurisdictions. History depth varies by company age.

Returns the filing history recorded at Companies House for one company: accounts, confirmation statements, officer changes, charge registrations, share allotments and mortgage filings. Use this to detect material change rather than re-polling the whole record.

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
`category`	Filter to one filing category: accounts, confirmation-statement, officers, capital, mortgage, insolvency, address, resolution, incorporation, annual-return, change-of-name, gazette.	Optional
`limit`	Number of filings to return. Default 25, maximum 100.	Optional
`cursor`	Pagination cursor returned as next_cursor by the previous call.	Optional

Example request

GET request

https://api.ukdatalayer.com/v1/company-filings?key=YOUR_KEY&company_number=00000042&limit=25

Output

Field	Type	Description
`filings[].category`	string	Filing category, e.g. accounts.
`filings[].type`	string	Companies House form type, e.g. AA, CS01, AP01.
`filings[].description`	string	Machine-readable description identifier as published by Companies House, e.g. accounts-with-accounts-type-full.
`filings[].date`	date	Date the filing was recorded.
`filings[].made_up_to`	date \| null	Period end the filing covers, where applicable.
`filings[].pages`	number \| null	Page count of the filed document.
`filings[].transaction_id`	string \| null	Companies House transaction ID for the filing.
`filings[].document_available`	boolean	Whether the source document can be retrieved.
`next_cursor`	string \| null	Pass back as cursor to fetch the next page. Null on the last page.

Example response

200 OK · application/json

{
  "status": "success",
  "credits_used": 1,
  "data": {
    "company_number": "00000042",
    "filings": [
      {
        "category": "accounts",
        "type": "AA",
        "description": "accounts-with-accounts-type-full",
        "date": "2025-09-18",
        "made_up_to": "2025-03-31",
        "pages": 24,
        "transaction_id": "SANDBOX0001",
        "document_available": true
      },
      {
        "category": "confirmation-statement",
        "type": "CS01",
        "description": "confirmation-statement-with-no-updates",
        "date": "2025-05-19",
        "made_up_to": "2025-05-11",
        "pages": 3,
        "transaction_id": "SANDBOX0002",
        "document_available": true
      }
    ],
    "next_cursor": null
  }
}