Get UK company accounts summary and due dates
company.uk.accountsv1.0.0betaregion GB
Return the statutory accounts position of a UK company from the official register — accounting reference date, the last accounts filed (type and period) and the next accounts due, including whether they are overdue. This is the accounts filing status, not the financial statements.
Account price
USD 0.002
per successful call · introductory
x402 price
USD 0.003
accountless, settled per call · introductory
Provenance
companies_house
cache: shared · ttl 300s
Endpoint
GET https://api-staging.eckari.com/v1/companies/uk/{companyNumber}/accounts
curl -i "https://api-staging.eckari.com/v1/companies/uk/01234567/accounts"
Without credentials the gateway responds 402 with a PAYMENT-REQUIRED header (x402 v2). Retry with PAYMENT-SIGNATURE. See docs.
Use when
- When are this UK company's accounts due?
- Are company 01234567's accounts overdue?
- What type of accounts did this company last file and for what period?
- What is the accounting reference date of this limited company?
Do not use when
- Need the actual financial figures (turnover, profit, balance sheet) — not provided by the register API.
- Need the list of filed documents; use company.uk.filings with category accounts.
- Only need whether the company is active; use company.uk.status.
Synonyms
accounts due date UK companyoverdue accounts Companies Houseaccounting reference datelast accounts filedannual accounts status
Input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"companyNumber"
],
"properties": {
"companyNumber": {
"type": "string",
"description": "Companies House company number. Whitespace is ignored and short numeric values are zero-padded to 8 characters.",
"minLength": 1,
"maxLength": 10,
"pattern": "^[A-Za-z0-9 ]+$"
}
}
}Output schema
{
"type": "object",
"additionalProperties": false,
"required": [
"company_number",
"company_name",
"has_accounts_information",
"accounting_reference_date",
"last_accounts",
"next_accounts"
],
"properties": {
"company_number": {
"type": "string"
},
"company_name": {
"type": "string"
},
"has_accounts_information": {
"type": "boolean",
"description": "Derived; false when the register holds no accounts block for this company."
},
"accounting_reference_date": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"day": {
"type": [
"integer",
"null"
]
},
"month": {
"type": [
"integer",
"null"
]
}
}
},
"last_accounts": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "Register accounts type (e.g. full",
"small": null,
"micro-entity": null,
"dormant": null,
"group).": null
},
"period_start_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"period_end_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"made_up_to": {
"type": [
"string",
"null"
],
"format": "date"
}
}
},
"next_accounts": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"period_start_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"period_end_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"due_on": {
"type": [
"string",
"null"
],
"format": "date"
},
"overdue": {
"type": [
"boolean",
"null"
]
}
}
}
}
}Example input · accounts_position
{
"companyNumber": "01234567"
}Example response
{
"data": {
"company_number": "01234567",
"company_name": "EXAMPLE TRADING LIMITED",
"has_accounts_information": true,
"accounting_reference_date": {
"day": 31,
"month": 12
},
"last_accounts": {
"type": "micro-entity",
"period_start_on": "2024-01-01",
"period_end_on": "2024-12-31",
"made_up_to": "2024-12-31"
},
"next_accounts": {
"period_start_on": "2025-01-01",
"period_end_on": "2025-12-31",
"due_on": "2026-09-30",
"overdue": false
}
},
"meta": {
"capability": "company.uk.accounts",
"version": "1.0.0",
"retrieved_at": "2026-08-17T12:00:00Z",
"source": "companies_house",
"freshness": "live",
"request_id": "req_example"
}
}