Find an SEC filer by its CIK, then read its annual financial statements in one standard JSON shape: income statement, balance sheet and cash flow figures, in the filing currency with a euro copy. Scale plan; SEC filers only.
The SEC publishes the financial statements of public companies as XBRL on EDGAR. This API reads the annual reports (10-K, 20-F and 40-F) and returns them mapped to the same set of figures used for the other countries, so a US issuer and a European one can sit in one table. The first call finds the company and works with the public demo key rk_live_demo_publichn. The second reads its statements: the financials endpoint answers the demo key with a 403 upgrade_required, so it is written with your own key (rk_live_...).
# 1. find the filer by its CIK (Apple Inc.) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=US&company_number=CIK-0000320193&limit=1' \ -H 'Authorization: Bearer rk_live_demo_publichn' # 2. its annual statements (use data[0].id from step 1) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/14000011354258/financials?country=US&years=2' \ -H 'Authorization: Bearer rk_live_...'
A CIK-<10 digits> search also finds the state registration that carries the CIK. The answer to step 1 (10 November 2026, shortened) shows the company number of that registration and the identifiers, the CIK among them:
{
"data": [
{
"id": 14000011354258,
"country": "US",
"company_number": "CA-806592",
"company_name": "APPLE INC.",
"identifiers": [
{ "type": "state_registration", "value": "CA-806592" },
{ "type": "cik", "value": "0000320193" },
{ "type": "ein", "value": "942404110" },
{ "type": "lei", "value": "HWUPKR0MPOU8FGXBT394" }
],
"status": "active",
...
}
],
"meta": { "search_mode": "company_number_exact", ... }
}
Step 2 returns the statements, most recent fiscal year first (10 November 2026, shortened with ...):
{
"data": {
"company": { "id": 14000011354258, "country": "US", "company_number": "CA-806592", "company_name": "APPLE INC.", ... },
"statements": [
{
"fiscal_year": 2026,
"period_start": "2025-09-28",
"period_end": "2026-09-26",
"statement_type": "consolidated",
"framework": "us_gaap",
"currency": "USD",
"accounts_type": "10-K",
"filing_date": "2026-11-03",
"figures": {
"revenue": 478834000000,
"gross_profit": 233602000000,
"operating_profit": 158063000000,
"net_profit": 132175000000,
"total_assets": 404548000000,
"equity": 112093000000,
"operating_cash_flow": 145097000000,
"free_cash_flow": 136056000000,
...
},
"ratios": {
"gross_margin": 0.4879,
"net_margin": 0.276,
"current_ratio": 1.0232,
...
},
"quality": {
"missing": {
"employees": "not_stated",
"provisions": "not_collected_for_source",
...
}
}
},
...
]
},
"meta": { "country": "US", "availability": "available", ... }
}
Every statement carries statement_type, framework (us_gaap or IFRS), accounts_type (the SEC form), the filing_date and a figures_eur copy at the ECB annual average rate; the fx block says which rate and year were used. A figure the filing does not state is null and quality.missing says why, so a missing line is never read as zero. free_cash_flow is derived as operating cash flow less capital expenditure and is listed in quality.derived.
EDGAR is the SEC's own system and the primary source: the filings, and their XBRL data, are free to read. The SEC's developer page (sec.gov/developer) sets out its fair-access guidelines for automated clients, and a program that reads EDGAR directly has to follow them; the SEC's own documentation is the reference for its endpoints, formats and limits.
What Prometiam adds is the layer on top of the XBRL facts of annual reports. The tags a filer used are mapped to a fixed set of figures, so revenue, net_profit and total_assets mean the same for Apple, for a Danish company and for a Brazilian issuer. You get ratios computed from those figures, a euro copy, a quality block and the SEC form, and the filer is found by CIK, by name or by any other identifier on the record, all with the same key and the same response shape as every other country.
| Question | The SEC (EDGAR XBRL) | Prometiam |
|---|---|---|
| Source | the SEC's own EDGAR; terms and fair-access rules on its developer pages | annual reports of SEC filers, from EDGAR XBRL |
| Filings | every form a filer submits | 10-K, 20-F, 40-F and their amendments |
| Figures | the filer's own XBRL tags | a fixed set of mapped figures, figures, ratios, quality |
| Years | see the SEC documentation | fiscal years from 2023, years= selects how many |
| Currency | as filed | filing currency plus a euro copy |
| Other countries | US filers only | same endpoint and fields in every country that has financial statements |
| Price | free | Scale plan EUR 99.99 a month; 25 credits for one company |
sec_filers_only and no statements, and it costs nothing.Financial statements are a Scale plan feature (EUR 99.99 a month, 50,000 credits). One company's statements cost 25 credits. Starter, Professional and free-trial keys can make 10 calls a month on this endpoint. The search that finds the id costs 1 credit, an answer with no statement held costs nothing, and an error response is free. years= takes how many fiscal years to return; the two used above are enough to see growth.
If you need every line item an issuer tagged, the full text of a filing or the notes, read the filing at the SEC: this API returns a fixed set of headline figures and ratios, not the whole report. If you read a handful of US issuers and write your own mapping, EDGAR is free and enough. The API is worth it when the same code has to read US issuers beside European companies, when you want ratios and a euro copy without writing the mapping, or when the filer has to be found from a CIK, a name or a state registration number first. To find SEC filers by name first, see the SEC EDGAR company search API.
Starter is EUR 9.99/month (1,000 credits), Professional EUR 29.99 (10,000 credits), Scale EUR 99.99 (50,000 credits) and Enterprise is priced to order. A company record costs 1 credit; error responses cost nothing. The 14-day free trial includes 500 credits, needs a card, charges nothing during the trial and then continues as Starter unless you cancel. Prices are public and there is no sales call. See pricing.
US sources: New York Department of State, Colorado Secretary of State, Connecticut Secretary of the State, Pennsylvania Department of State (open data), Florida Department of State, Division of Corporations (public records), Iowa Secretary of State (CC BY 4.0), District of Columbia Department of Licensing and Consumer Protection (CC BY 4.0), Texas Comptroller of Public Accounts (franchise tax data), Oregon Secretary of State, Corporation Division (open data), Massachusetts Secretary of the Commonwealth, Corporations Division (public-record extract of 19 Oct 2026; not an official register extract and not endorsed by the Secretary), SEC EDGAR, GLEIF (CC0)
The free trial lasts 14 days and includes 500 credits. A card is required and nothing is charged during the trial; it then continues as Starter (EUR 9.99/month) unless you cancel.