{"openapi":"3.1.0","info":{"title":"Trading Agent Data: Company Financials API","version":"2026-11-08","summary":"Company financial statements from official filings in thirteen markets, each figure keyed to its filing date (Australia: tax figures, dated by publication).","description":"Annual accounts and financial statements from official company registers and regulators: France (INPI), Belgium (National Bank of Belgium), Denmark (Danish Business Authority), Sweden (Bolagsverket), Estonia (e-Business Register), Slovakia (Register of Financial Statements), Latvia (Register of Enterprises), Japan (FSA EDINET), New Zealand registered charities (Charities Register), and listed issuers from US SEC EDGAR, Taiwan TWSE and Korea OpenDART. Most entities are private companies. Australia is the thirteenth market: official income figures for large entities from the Australian Taxation Office (total income, taxable income and tax payable), which are tax return figures, not accounts.\n\nEvery row carries `filed`, the filing date as each market records it. Query with `as_of` and you get only rows filed on or before that day. Some markets use a stated proxy date; each market's rule is in the `schema` field of a history response and at https://www.tradingagentapp.com/fundamentals/methodology.\n\nKeys. The public demo key is the word `demo`: every company at its most recent reported fiscal year, all fields, and full history for the sample companies the index lists in `free_tier.full_history_sample`. A 30-day evaluation key (work email, https://www.tradingagentapp.com/fundamentals/evaluate) reads full history and `as_of` for up to 1,000 companies. Full history and `as_of` otherwise need a Personal or Commercial data licence; whole-market bulk files come with the Redistribution Licence, the Academic Institution Licence and, where its Order Form says so, an OEM Agreement.\n\nLicence. Data read with the demo key or a key without a data licence is Free Data under the Trading Agent Data Free Licence (https://www.tradingagentapp.com/licences/free), and those responses say so in `licence`. Every JSON response carries `attribution`, the source notice of each market it contains; keep it with the data (Source Conditions Schedule, https://www.tradingagentapp.com/licences/sources).\n\nRate limits are published at https://www.tradingagentapp.com/developers#rate-limits. A request over a limit gets HTTP 429 with Retry-After and X-RateLimit-* headers.\n\nThis is factual, historical data from filings. It is not investment advice.","contact":{"email":"william@tradingagentapp.com","url":"https://www.tradingagentapp.com/developers"},"termsOfService":"https://www.tradingagentapp.com/licences","license":{"name":"Trading Agent Data licences (each market's data also under its source's own terms)","url":"https://www.tradingagentapp.com/licences"}},"externalDocs":{"description":"Reference, ID formats and rate limits","url":"https://www.tradingagentapp.com/developers"},"servers":[{"url":"https://www.tradingagentapp.com"}],"security":[{"bearer":[]},{"apiKey":[]}],"tags":[{"name":"Fundamentals","description":"Per-company figures, by filing date."},{"name":"Bulk","description":"Whole markets as gzipped CSV files, for licences that include them."},{"name":"Reference","description":"Lookup, coverage, data quality, definitions, attribution and deletions."}],"paths":{"/api/v1/fundamentals":{"get":{"tags":["Fundamentals"],"operationId":"getFundamentals","summary":"Index, filing-dated history, or the latest value of each metric","description":"Without `ticker`: the index (markets, coverage counts, metric codes, attribution, notes per market). With `ticker`: the company's rows, filed on or before `as_of` (`view=history`, the default), or one value per metric (`view=latest`).\n\nWith the demo key or a key without a data licence, a company outside the sample answers with its most recent reported fiscal year only: `full_history` is false and `history_depth` says why, and `as_of` answers 403 `as_of_requires_a_plan`. The same applies to a Personal or Commercial account past its company limit (403 `as_of_past_company_limit`).","parameters":[{"name":"ticker","in":"query","required":false,"description":"The entity's ID: the register's own identifier with a market suffix. AAPL (US ticker), 0001037540.US (the 10-digit CIK of a US issuer no longer on the SEC's ticker list), E01766.JP (EDINET code), 005930.KS or .KQ (KRX stock code), 2330.TW, 387949530.FR (SIREN), 0403091220.BE (ten-digit enterprise number), 14227547.DK (CVR), 10238429.EE, 5560356163.SE, 54490383.SK, 40003032949.LV, CC21860.NZC (charity registration number). Omit for the index. Find an ID with GET /api/search.","schema":{"type":"string"},"example":"AAPL"},{"name":"view","in":"query","required":false,"description":"history (default): every row. latest: one value per metric, each with its own fy, fp, period end, filing date and form; a quarterly fp is one quarter's figure.","schema":{"type":"string","enum":["history","latest"],"default":"history"}},{"name":"as_of","in":"query","required":false,"description":"Filing-date cutoff, YYYY-MM-DD: only rows filed on or before this day. Default today. Any other spelling answers 400 invalid_as_of. Needs full-history access (see the description above).","schema":{"type":"string","format":"date"},"example":"2022-01-01"},{"name":"metric","in":"query","required":false,"description":"Comma list of metric codes, in either view: history returns only those rows, latest only those metrics. A code we do not hold is left out. Omit for all. The index lists the codes in `metrics` and `line_items`; GET /api/v1/fundamentals/dictionary defines the line items.","schema":{"type":"string"},"example":"revenue,net_income,assets"},{"name":"from","in":"query","required":false,"description":"Period-end lower bound, YYYY-MM-DD (history view). Any other spelling answers 400 invalid_from.","schema":{"type":"string","format":"date"}},{"name":"market","in":"query","required":false,"description":"Optional market filter. Without `ticker`, it limits the index's ticker count to that market.","schema":{"$ref":"#/components/schemas/Market"}},{"name":"format","in":"query","required":false,"description":"json (default) or csv. CSV is the history view only; it carries the attribution on every row (source_attribution) and the depth and licence notice in the X-Data-Depth and X-Data-Licence headers.","schema":{"type":"string","enum":["json","csv"],"default":"json"}}],"responses":{"200":{"description":"The index (no ticker), the history view or the latest view. Each JSON reply has an `object` field naming which.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/FundamentalsHistory"},{"$ref":"#/components/schemas/FundamentalsLatest"},{"$ref":"#/components/schemas/FundamentalsIndex"}]}},"text/csv":{"schema":{"type":"string","description":"UTF-8 with a byte-order mark. Columns: market, ticker, issuer_id, metric, fy, fp, period_end, filed, form, basis, value, unit, source_attribution."}}}},"400":{"description":"invalid_as_of or invalid_from: the date is not written YYYY-MM-DD. unknown_market: `market` is not a market code this API serves; `markets` lists them.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"as_of_requires_a_plan (as_of on the demo key or a key without a data licence, for a company outside the sample), as_of_past_company_limit (as_of for a company past a Personal or Commercial account's company limit), evaluation_entity_limit (an evaluation key past its 1,000 companies), evaluation_ended (an evaluation key past its end date), or market_not_licensed (a company outside the markets an Order Form or evaluation key names).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"evaluation_check_failed: an evaluation key's company count could not be read. Try again in a moment.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fundamentals/bulk":{"get":{"tags":["Bulk"],"operationId":"getBulkFile","summary":"Whole-market files: the list, or a 15-minute download link","description":"Without `market`: what is published for each market (date, data date, rows, entities, bytes, SHA-256, filing-date range), on any key. With `market`: the file's manifest and, for the Redistribution Licence, the Academic Institution Licence and an OEM Agreement whose Order Form includes bulk files, a signed link valid for 900 seconds. Every other key gets the manifest with a 403 that says why. Save `attribution_url` as ATTRIBUTION.txt beside the file. To test a loader and a hash check first, use the public bulk sample at /samples/bulk/US/2026-11-08/ (manifest.json, ATTRIBUTION.txt and the .csv.gz).","parameters":[{"name":"market","in":"query","required":false,"schema":{"$ref":"#/components/schemas/Market"},"example":"US"}],"responses":{"200":{"description":"The list (no market), or the manifest with `url`, `filename` and `expires_in`.","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/BulkIndex"},{"$ref":"#/components/schemas/BulkFile"}]}}}},"400":{"description":"unknown_market: not a market with a bulk file. `markets` lists them.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"The manifest, with error bulk_requires_redistribution (this key's licence does not include bulk files), bulk_not_in_order_form (an OEM Order Form without bulk files) or licence_under_review (a Redistribution order still being checked). Or an error alone: evaluation_ended, or market_not_licensed (a market the OEM Order Form does not name).","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BulkFile"},{"$ref":"#/components/schemas/Error"}]}}}},"404":{"description":"not_published: no bulk file for this market yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"},"503":{"description":"temporarily_unavailable: the file exists but could not be signed. Retry in a minute.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fundamentals/sample":{"get":{"tags":["Bulk"],"operationId":"getSampleCsv","summary":"The public sample file (CSV, no key)","description":"A fixed file: for each market one company across every fiscal year, and others with every metric for their latest year. Rows listed in the deletions feed are dropped. Free Data under the Free Licence. The X-Sample-Rows and X-Sample-Companies headers count what is in the file.","security":[],"responses":{"200":{"description":"CSV with a header row and a source_attribution column.","headers":{"X-Sample-Rows":{"schema":{"type":"integer"}},"X-Sample-Companies":{"schema":{"type":"integer"}}},"content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/api/v1/fundamentals/attribution":{"get":{"tags":["Reference"],"operationId":"getAttributionFile","summary":"ATTRIBUTION.txt for a set of markets (no key)","description":"The source and licence notices to keep beside a bulk file or a snapshot, each dated with the data date of that market's current bulk file unless a date is given.","security":[],"parameters":[{"name":"markets","in":"query","required":false,"description":"Comma list of market codes, each optionally with its data date: FR,DK or FR:2026-09-28,DK:2026-09-29. Omit for every market.","schema":{"type":"string"},"example":"US"},{"name":"date","in":"query","required":false,"description":"One data date, YYYY-MM-DD, for every market without its own.","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Plain text.","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"unknown_market: a market whose notice the licence in force does not carry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/fundamentals/deletions":{"get":{"tags":["Reference"],"operationId":"getDeletions","summary":"The Deletions Feed","description":"Every record removed from the Data, with its market, identifier, listing date and action (withdrawn, delete or correction). Holders apply it as clause 11 of the Data Terms requires; `obligation` summarises the deadlines. Any valid key may read it, including an evaluation key that has ended.","parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string"},"example":"FR"},{"name":"since","in":"query","required":false,"description":"Listing date lower bound, YYYY-MM-DD (a full timestamp is read as its date).","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"The feed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deletions"}}}},"400":{"description":"unknown_market, or bad_since (since is not YYYY-MM-DD).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"market_not_licensed: a market outside an evaluation key's list.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/fundamentals/quality":{"get":{"tags":["Reference"],"operationId":"getQuality","summary":"Measured share of company-periods carrying each metric (no key needed)","description":"Per market: the share of company-periods that carries each metric, and the balance-sheet identity failure rate. Without a key it is rate-limited per IP address and the per-market report leaves out the identity-check examples, which quote companies' figures; with a key, those examples are included.","security":[{},{"bearer":[]},{"apiKey":[]}],"parameters":[{"name":"market","in":"query","required":false,"description":"One market's full report.","schema":{"type":"string"},"example":"FR"}],"responses":{"200":{"description":"The index across markets, or one market's report.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quality"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"not_published: no quality report for this market yet.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/fundamentals/dictionary":{"get":{"tags":["Reference"],"operationId":"getDictionary","summary":"Data dictionary of the detailed line items","description":"For every line-item metric: what it means, and per market which filed line it is read from or why there is none, with the measured share of company-periods that carry it. Any key, the demo key included.","responses":{"200":{"description":"The dictionary.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Dictionary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/fundamentals/group-structure":{"get":{"tags":["Reference"],"operationId":"getGroupStructureSummary","summary":"Group structure summary for one entity","description":"A summary of one entity's place in the group-structure file (GLEIF relationship records): whether the file holds a current direct and a current ultimate accounting consolidating parent for it, and how many current direct subsidiaries it has there, with the golden-copy date. The same for every key, the demo key included. No names, LEIs, register numbers, periods or percentages: the relationships themselves are supplied only under an Order Form that names group structure data (Data Terms clause 5.1B; https://www.tradingagentapp.com/fundamentals/group-structure).","parameters":[{"name":"id","in":"query","required":true,"description":"A ticker (e.g. FOXF, or a register-number ticker such as 493455042.FR) or a 20-character LEI (ISO 17442).","schema":{"type":"string","maxLength":40}}],"responses":{"200":{"description":"The summary.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupStructureSummary"}}}},"400":{"description":"bad_id: id is missing, too long, or an LEI whose check digits do not match.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/api/v1/fundamentals/coverage":{"get":{"tags":["Reference"],"operationId":"checkCoverageGet","summary":"Check up to 50 IDs or names (no key)","description":"Whether we hold filings for each line, the entity it resolved to, its market and the fiscal years on file. No figures. Nothing sent is stored. 20 requests a minute and 5,000 lines an hour per IP address.","security":[],"parameters":[{"name":"q","in":"query","required":true,"description":"An identifier (AAPL, 652014051.FR, 0403091220.BE, 14227547.DK, E01766, 00126380, 2330, CC21860) or \"name, country\". Repeat for more lines, up to 50.","schema":{"type":"array","items":{"type":"string"},"maxItems":50},"style":"form","explode":true,"example":["AAPL","0403091220.BE"]}],"responses":{"200":{"description":"One result per line, and the match rate.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coverage"}}}},"400":{"$ref":"#/components/responses/CoverageBadRequest"},"429":{"$ref":"#/components/responses/CoverageRateLimited"}}},"post":{"tags":["Reference"],"operationId":"checkCoveragePost","summary":"Check up to 1,000 IDs or names (no key)","description":"As the GET form, for up to 1,000 lines (at most 100 of them names). Send JSON { \"lines\": [...] } or a text/plain body with one line each.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":1000}},"required":["lines"]},"example":{"lines":["AAPL","652014051.FR","Novo Nordisk, Denmark"]}},"text/plain":{"schema":{"type":"string"}}}},"responses":{"200":{"description":"One result per line, and the match rate.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coverage"}}}},"400":{"$ref":"#/components/responses/CoverageBadRequest"},"413":{"description":"too_large: the body is over 256 KB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/CoverageRateLimited"}}}},"/api/search":{"get":{"tags":["Reference"],"operationId":"searchCompanies","summary":"Find an entity's ID from its name, symbol or registration number (no key)","description":"Up to 8 hits. Order: an exact ID, then IDs that start with the query, then names that start with it, then names that contain it. Pass `ticker` to /api/v1/fundamentals as it is. Counted per IP address.","security":[],"parameters":[{"name":"q","in":"query","required":true,"description":"A name, a symbol or a registration number; not case-sensitive.","schema":{"type":"string"},"example":"solvay"},{"name":"market","in":"query","required":false,"description":"Keep one market.","schema":{"type":"string"}}],"responses":{"200":{"description":"The hits.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"name":{"type":["string","null"]},"market":{"type":["string","null"]}},"required":["ticker","name","market"]}}},"required":["results"]}}}},"400":{"description":"invalid_market: market is not a market code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"$ref":"#/components/responses/RateLimited"}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Authorization: Bearer <key>. The public demo key is the word demo. Your own keys (ta_live_…) are at https://www.tradingagentapp.com/account/api-keys."},"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"The same key in the x-api-key header."}},"headers":{"X-RateLimit-Limit":{"description":"Requests a minute on this key or address.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests left in this minute.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix time the minute window resets. Keys with a daily limit also get X-RateLimit-Limit-Day, X-RateLimit-Remaining-Day and X-RateLimit-Reset-Day.","schema":{"type":"integer"}}},"responses":{"Unauthorized":{"description":"unauthorized: no valid key. Send Authorization: Bearer <key> or x-api-key. A browser opening the URL with no key is redirected to /developers instead.","headers":{"WWW-Authenticate":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"rate_limited: over the minute or day limit. Retry after Retry-After seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"CoverageBadRequest":{"description":"no_lines, too_many_lines or invalid_json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"CoverageRateLimited":{"description":"rate_limited (20 requests a minute) or line_budget (5,000 lines an hour), per IP address.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Market":{"type":"string","description":"Market code. NZC is the New Zealand Charities Register (registered charities, not companies).","enum":["US","JP","KR","TW","FR","BE","DK","EE","SE","SK","LV","NZC"]},"Error":{"type":"object","properties":{"error":{"type":"string","description":"A stable code, such as invalid_as_of or as_of_requires_a_plan."},"message":{"type":"string","description":"What happened and what to do, in plain words."}},"required":["error"],"additionalProperties":true},"Licence":{"type":"object","description":"Present on responses to the demo key, keys without a data licence (Free Licence) and evaluation keys (Evaluation Terms).","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"notice":{"type":"string"}},"required":["name","url","notice"]},"Attribution":{"type":"object","description":"The source notice of each market in the response, by market code. Keep it with the data.","additionalProperties":{"type":"string"}},"HistoryDepth":{"type":"object","description":"Present when the reply is the company's most recent fiscal year only.","properties":{"scope":{"type":"string","example":"latest_fiscal_year_only"},"note":{"type":"string"}},"additionalProperties":true},"Company":{"type":"object","description":"The register's entry for the company.","properties":{"ticker":{"type":"string"},"market":{"type":"string"},"name":{"type":["string","null"]},"activity_code":{"type":["string","null"],"description":"Industry code where we hold one: France APE/NAF, Sweden SNI, Estonia EMTAK, Slovakia SK NACE. With as_of, given only where its date is known to be on or before that day."},"address":{"type":["string","null"],"description":"Postcode and locality, where the source states them. Null with as_of."},"basis":{"type":["string","null"],"description":"The basis shared by every figure in `data`, or null where they differ."},"source":{"type":"object","properties":{"register":{"type":"string"},"id":{"type":"string"},"url":{"type":["string","null"]}},"additionalProperties":true}},"additionalProperties":true},"Basis":{"type":"string","enum":["consolidated","solo","reported"],"description":"consolidated = the group; solo = the legal entity's own accounts; reported = as published (Danish filings do not label it)."},"Row":{"type":"object","description":"One figure from one filing.","properties":{"mkt":{"type":"string","description":"Market code."},"t":{"type":"string","description":"The ID sent as ticker."},"c":{"type":"string","description":"The register's raw identifier (issuer_id): CIK, corp_code, SIREN, NZBN …"},"m":{"type":"string","description":"Metric code."},"fy":{"type":"integer","description":"Fiscal year for an annual row; the calendar year of the period end for a quarterly row."},"fp":{"type":"string","description":"FY for an annual row; for a quarterly row the calendar quarter (Q1 to Q4) that contains its period end."},"end":{"type":"string","format":"date","description":"Period end."},"filed":{"type":"string","format":"date","description":"The filing date as the market records it: what as_of filters on."},"form":{"type":"string","description":"Filing type (10-K, 10-Q, annual …, with market suffixes; derived for calculated figures)."},"v":{"type":"number","description":"Value."},"u":{"type":"string","description":"Unit (USD, EUR, DKK, KRW, TWD, shares, ratio …)."},"basis":{"$ref":"#/components/schemas/Basis"},"src":{"type":"string","description":"The register's own id for the filing, where the source gives one."}},"required":["mkt","t","c","m","fy","fp","end","filed","form","v","u","basis"],"additionalProperties":true},"Fact":{"type":"object","description":"One metric's latest value, with the period and filing it comes from.","properties":{"value":{"type":"number"},"fy":{"type":"integer"},"fp":{"type":"string"},"end":{"type":"string","format":"date"},"filed":{"type":"string","format":"date"},"form":{"type":"string"},"unit":{"type":"string"},"basis":{"$ref":"#/components/schemas/Basis"},"stale":{"type":"boolean","description":"Present and true only where the company has filed since without reporting this metric again."}},"required":["value","fy","fp","end","filed","form","unit"],"additionalProperties":true},"FundamentalsHistory":{"type":"object","properties":{"object":{"const":"fundamentals"},"ticker":{"type":"string"},"as_of":{"type":"string","format":"date"},"point_in_time":{"type":"string"},"count":{"type":"integer"},"full_history":{"type":"boolean"},"history_depth":{"$ref":"#/components/schemas/HistoryDepth"},"attribution":{"$ref":"#/components/schemas/Attribution"},"licence":{"$ref":"#/components/schemas/Licence"},"company":{"$ref":"#/components/schemas/Company"},"attributes":{"type":"object","description":"Estonia and Sweden only: the register's industry code and, for Estonia, shareholders that are legal persons, each with its source and date.","additionalProperties":true},"schema":{"type":"object","description":"What each row field means, with each market's dating rule.","additionalProperties":{"type":"string"}},"data":{"type":"array","items":{"$ref":"#/components/schemas/Row"}}},"required":["object","ticker","as_of","count","full_history","attribution","data"],"additionalProperties":true},"FundamentalsLatest":{"type":"object","properties":{"object":{"const":"fundamentals_latest"},"ticker":{"type":"string"},"as_of":{"type":"string","format":"date"},"point_in_time":{"type":"string"},"full_history":{"type":"boolean"},"history_depth":{"$ref":"#/components/schemas/HistoryDepth"},"attribution":{"$ref":"#/components/schemas/Attribution"},"licence":{"$ref":"#/components/schemas/Licence"},"company":{"$ref":"#/components/schemas/Company"},"schema":{"type":"object","additionalProperties":{"type":"string"}},"attributes":{"type":"object","additionalProperties":true},"data":{"type":"object","description":"One Fact per metric code. With `metric`, only those metrics.","additionalProperties":{"$ref":"#/components/schemas/Fact"}}},"required":["object","ticker","as_of","full_history","attribution","data"],"additionalProperties":true},"FundamentalsIndex":{"type":"object","properties":{"object":{"const":"fundamentals_index"},"tier":{"type":"string","description":"The key's tier, for example demo."},"free_tier":{"type":"object","description":"For the demo key and keys without a data licence: what they read, and `full_history_sample`, the companies that answer at full depth on any key.","additionalProperties":true},"evaluation":{"type":"object","description":"For an evaluation key: end date, companies used and limit.","additionalProperties":true},"licence":{"$ref":"#/components/schemas/Licence"},"notes":{"type":"object","description":"What to know about each market.","additionalProperties":{"type":"string"}},"attribution":{"$ref":"#/components/schemas/Attribution"},"markets":{"type":"array","items":{"type":"string"}},"coverage":{"type":["array","null"],"description":"Per market: entities (tickers), rows, filing-date range, update time, reporting basis and fill rates.","items":{"type":"object","properties":{"market":{"type":"string"},"tickers":{"type":"integer"},"rows":{"type":"integer"}},"additionalProperties":true}},"also":{"type":"object","description":"Australia, one of the thirteen markets, served here rather than in `markets` and `coverage` because its data are official income figures for large entities from the Australian Taxation Office (tax figures, not accounts), where present.","additionalProperties":true},"ticker_count":{"type":"integer","description":"Entities across every market, from the manifests (or in `market` when given)."},"tickers":{"type":"array","items":{"type":"string"},"description":"Inlined only when short enough; otherwise see tickers_note."},"tickers_note":{"type":"string"},"metrics":{"type":"array","items":{"type":"string"}},"line_items":{"type":"object","additionalProperties":true},"manifests":{"type":"object","additionalProperties":true}},"required":["object","tier","markets","ticker_count","metrics"],"additionalProperties":true},"BulkIndex":{"type":"object","properties":{"object":{"const":"fundamentals_bulk_index"},"tier":{"type":"string"},"markets":{"type":"object","additionalProperties":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Build date, which names the file."},"data_date":{"type":"string","format":"date","description":"The date we last updated the data the file holds."},"rows":{"type":"integer"},"tickers":{"type":"integer"},"bytes":{"type":"integer"},"sha256":{"type":"string"},"filed_min":{"type":["string","null"]},"filed_max":{"type":["string","null"]}},"additionalProperties":true}},"columns":{"type":["array","null"],"items":{"type":"string"}},"how":{"type":"string"},"updated_at":{"type":["string","null"]}},"required":["object","markets"],"additionalProperties":true},"BulkFile":{"type":"object","properties":{"object":{"const":"fundamentals_bulk"},"market":{"type":"string"},"date":{"type":"string","format":"date"},"data_date":{"type":"string","format":"date"},"rows":{"type":"integer"},"tickers":{"type":"integer"},"bytes":{"type":"integer"},"sha256":{"type":"string"},"columns":{"type":"array","items":{"type":"string"}},"built_at":{"type":"string"},"filed_min":{"type":["string","null"]},"filed_max":{"type":["string","null"]},"coverage":{"type":["object","null"],"additionalProperties":{"type":"number"}},"attribution":{"$ref":"#/components/schemas/Attribution"},"attribution_url":{"type":"string","format":"uri"},"url":{"type":"string","format":"uri","description":"Signed download link, on a licence that includes bulk files."},"filename":{"type":"string"},"expires_in":{"type":"integer","description":"Seconds the link stays valid (900)."},"licence":{"type":"string"},"error":{"type":"string","description":"On a 403: why there is no link."},"message":{"type":"string"}},"required":["object","market","date","data_date","rows","tickers","sha256"],"additionalProperties":true},"Deletions":{"type":"object","properties":{"object":{"const":"fundamentals_deletions"},"since":{"type":["string","null"]},"count":{"type":"integer"},"obligation":{"type":"string"},"deletions":{"type":"object","description":"Entries by market code.","additionalProperties":{"type":"array","items":{"type":"object","properties":{"ticker":{"type":"string"},"period_end":{"type":["string","null"]},"form":{"type":["string","null"]},"source_id":{"type":["string","null"]},"deleted_at":{"type":"string","format":"date"},"action":{"type":"string","enum":["withdrawn","delete","correction"]}},"additionalProperties":true}}},"attribution":{"$ref":"#/components/schemas/Attribution"}},"required":["object","count","obligation","deletions"],"additionalProperties":true},"Quality":{"type":"object","properties":{"object":{"type":"string","enum":["fundamentals_quality_index","fundamentals_quality"]},"markets":{"type":"object","additionalProperties":{"type":"object","properties":{"periods":{"type":"integer"},"fill_rates":{"type":"object","additionalProperties":{"type":"number"}},"balance_sheet_identity_failures":{"type":"number"},"checked_at":{"type":"string"}},"additionalProperties":true}},"attribution":{"$ref":"#/components/schemas/Attribution"}},"required":["object"],"additionalProperties":true},"Dictionary":{"type":"object","properties":{"object":{"const":"fundamentals_dictionary"},"version":{"type":"string"},"metrics":{"type":"array","items":{"type":"object","properties":{"m":{"type":"string"},"label":{"type":"string"},"statement":{"type":"string"},"kind":{"type":"string"},"definition":{"type":"string"},"markets":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"derived":{"type":"array","items":{"type":"object","additionalProperties":true}},"attribution":{"$ref":"#/components/schemas/Attribution"}},"required":["object","metrics"],"additionalProperties":true},"GroupStructureSummary":{"type":"object","properties":{"object":{"const":"group_structure_summary"},"id_type":{"enum":["ticker","lei"]},"ticker":{"type":"string","description":"The ticker asked for. An LEI asked for is not echoed."},"golden_copy":{"type":"string","description":"The GLEIF golden copy the file was built from, e.g. 2026-11-16 16:00."},"found":{"type":"boolean"},"summary":{"type":"object","properties":{"current_direct_parent":{"type":"boolean"},"current_ultimate_parent":{"type":"boolean"},"current_direct_subsidiaries":{"type":"integer","minimum":0}}},"entities_matched":{"type":"integer","description":"Where a ticker is linked to more than one LEI record: how many; each is summarised in summaries."},"summaries":{"type":"array","items":{"type":"object","additionalProperties":true}},"ticker_link":{"enum":["register_number","name_only","name_confirmed","mixed"],"description":"How the ticker is linked to the GLEIF record: by register number; for the United States by name only, or by a name match that SEC data supports (the state of incorporation, or a GLEIF subsidiary named in the issuer's 10-K Exhibit 21). A name link is never an identifier."},"ticker_link_note":{"type":"string"},"scope":{"type":"string"},"meaning":{"type":"string"},"note":{"type":"string"},"exhibit_21":{"type":"object","description":"US tickers only: how many subsidiaries the issuer lists in Exhibit 21 to its latest 10-K (SEC EDGAR, Source Conditions Schedule clause 3.17). A count, never names.","properties":{"listed_subsidiaries":{"type":"integer","minimum":0},"read":{"type":["string","null"],"format":"date"},"meaning":{"type":"string"}}},"full_relationships":{"type":"object","properties":{"supplied_by":{"type":"string"},"docs":{"type":"string","format":"uri"},"sample":{"type":"string","format":"uri"},"ex21_sample":{"type":"string","format":"uri"}}},"gleif_conditions":{"type":"array","items":{"type":"string"},"description":"Source Conditions Schedule clause 3.16, conditions (a) and (b), word for word."},"sec_conditions":{"type":"array","items":{"type":"string"},"description":"With exhibit_21: Source Conditions Schedule clause 3.7, conditions (a) to (c), which clause 3.17 applies, word for word."},"attribution":{"type":"object","additionalProperties":{"type":"string"}}},"required":["object","id_type","golden_copy","found","full_relationships","gleif_conditions","attribution"],"additionalProperties":true},"Coverage":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"line":{"type":"integer"},"input":{"type":"string"},"matched":{"type":"boolean"},"id":{"type":"string"},"name":{"type":["string","null"]},"market":{"type":"string"},"fy_from":{"type":"integer"},"fy_to":{"type":"integer"},"fy_count":{"type":"integer"},"match":{"type":"string"}},"required":["line","input","matched"],"additionalProperties":true}},"summary":{"type":"object","additionalProperties":true},"limits":{"type":"object","additionalProperties":true},"note":{"type":"string"},"attribution":{"$ref":"#/components/schemas/Attribution"}},"required":["results","summary"],"additionalProperties":true}}}}