10-K and XBRL company facts by API: limits and fields
How the SEC EDGAR API serves 10-K filings and XBRL company facts: the free endpoints, the user-agent rule, the rate limit and the fields that matter.
Updated 15 November 2026
Guide · UK Company Data
The Companies House API is free. You register on the Companies House Developer Hub, create an application with an API key, and send that key with every request as the username of HTTP Basic authentication, with an empty password. Each application can make up to 600 requests in a five-minute window; past that you get HTTP 429 until the window resets (Companies House, Rate limiting, read 15 November 2026).
API Key application”. That gives it a unique key (Authorisation, read 15 November 2026).curl -XGET -u my_api_key: https://api.company-information.service.gov.uk/company/00000006
Note the colon after the key: it tells curl the password is empty. In Python:
import requests
key = "your-rest-api-key"
r = requests.get(
"https://api.company-information.service.gov.uk/company/00445790",
auth=(key, ""), timeout=30,
)
print(r.json()["company_name"])
The rule, in Companies House’s own words: “You can make up to 600 requests within a five-minute period. If you exceed this limit, you will receive a 429 Too Many Requests HTTP status code for each request made within the remainder of the five-minute window.” The limit then resets to 600 (Rate limiting page, read 15 November 2026).
Three practical points:
How far 600 requests go depends on how many endpoints you call per company. A profile alone is one request; profile, filing history, charges and insolvency is four.
All calls go to https://api.company-information.service.gov.uk and take the company number, for example 00445790 for Tesco PLC. The API reference groups them as follows (read 15 November 2026).
| Endpoint | What it gives you |
|---|---|
/company/{company_number} |
Company profile: name, status, type, creation date, registered office, SIC codes, accounts and confirmation statement dates, previous names, whether it has charges or insolvency history |
/company/{company_number}/filing-history |
Every filing with date, category, type and description; filter with category, page with items_per_page and start_index |
/company/{company_number}/officers |
Directors and secretaries, with appointment dates |
/company/{company_number}/charges |
Mortgages and other secured charges, with status |
/company/{company_number}/insolvency |
Insolvency cases and their dates |
/company/{company_number}/persons-with-significant-control |
People and companies with significant control |
/search/companies |
Search by name |
The filing history parameters above are as documented on the filing history list reference; a company with no filing history returns 404.
Officer and PSC data names real people. If you collect it, you need a lawful basis under UK GDPR or your own law.
The profile tells you when accounts were last made up to and when the next ones are due, but not the figures. The figures sit in the accounts document itself.
By API. Each accounts filing in the filing history links to a document. The Document API has two calls: GET /document/{document_id} for the metadata and GET /document/{document_id}/content for the file itself. The content call needs an Accept header naming the format you want; the formats on offer are listed in the metadata, and an unsupported one returns 406. A successful call answers with a 302 redirect to the file (Document API reference, read 15 November 2026). Accounts filed electronically are often available as inline XBRL (iXBRL), an HTML page with machine-readable tags; in our runs, some accounts were PDF only.
In bulk. Companies House publishes a free Accounts Data Product: a ZIP file each morning, Tuesday to Saturday, with the accounts registered the previous day (Tuesday’s covers Saturday to Monday). Each daily file stays up for 60 days, then the data moves to monthly files. Inside are iXBRL (.html), XBRL (.xml) or zipped iXBRL files named with the company number and balance sheet date. The page says the files are free and “not supported” (read 15 November 2026).
If you want the register for every company rather than a list, start with the free downloads. The Company data product is a monthly snapshot of live companies in CSV, with company type, registered office, SIC codes, status, accounts and confirmation statement dates and previous names. It is compiled to the end of the previous month and published within 5 working days (GOV.UK guidance, last updated 25 October 2022, read 15 November 2026).
If you have a list of companies and want fresh data, one row each, without writing code, that is what our two tools do.
UK Company Data (tool page, Apify Store) reads the profile, filing history, charges and insolvency for each company number or name. A real input:
{
"apiKey": "your-rest-api-key",
"companyNumbers": ["00445790"],
"includeFilingHistory": true,
"maxFilingsPerCompany": 25
}
A real row from a test run on 13 November 2026, shortened:
{
"input": "445790",
"status": "ok",
"companyNumber": "00445790",
"companyName": "TESCO PLC",
"companyStatus": "active",
"companyType": "plc",
"dateOfCreation": "1947-11-27",
"sicCodes": ["47110"],
"accounts": { "lastMadeUpTo": "2026-02-28", "nextDue": "2027-08-26", "overdue": false },
"confirmationStatement": { "lastMadeUpTo": "2026-06-18", "nextDue": "2027-07-02", "overdue": false },
"hasCharges": false,
"hasInsolvencyHistory": false,
"filingHistory": [{ "date": "2026-11-09", "category": "officers", "type": "AP01",
"description": "appoint-person-director-company-with-name-date", "pages": 2 }],
"filingHistoryTotal": 8373,
"registryUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790"
}
It costs from USD 1.25 per 1,000 companies; companies not found, invalid numbers and failed rows are free. It keeps to the key’s limit: with the default parts, 1,000 companies took about 19 minutes in our test on 13 November 2026, and when the window is used up the run waits and goes on. Officers and PSCs are off by default.
UK Company Financials (tool page, Apify Store) reads the latest iXBRL accounts and returns the balance sheet: net assets, current assets, net current assets, creditors due within one year, cash and average employees. A real row from a cloud run on 14 November 2026, shortened:
{
"companyNumber": "06534961",
"status": "ok",
"accountsType": "total-exemption-full",
"periodEnd": "2025-03-31",
"filingDate": "2025-10-21",
"currency": "GBP",
"netAssets": 241481,
"currentAssets": 431975,
"creditorsWithinYear": 235753,
"cash": 183117,
"employees": 11,
"documentFormat": "xhtml"
}
It costs from USD 5.00 per 1,000 companies. Companies whose latest accounts are PDF only come back as free pdf-only rows, with the link. It returns no turnover or profit, because most small companies file no profit and loss account. Give it a monitor name and schedule it, and later runs return only companies that filed new accounts, with the figures that moved.
All read on 15 November 2026. The Companies House developer pages show no publication date.
How the SEC EDGAR API serves 10-K filings and XBRL company facts: the free endpoints, the user-agent rule, the rate limit and the fields that matter.
Updated 15 November 2026
How to check SPF, DKIM and DMARC for a whole list of domains: what each record does, the rules mailbox providers enforce and the mistakes that break mail.
Updated 15 November 2026