{"openapi":"3.1.0","info":{"title":"Filing Studio API","version":"0.1.0"},"components":{"schemas":{"AccountKeyCreate":{"properties":{"name":{"type":"string","title":"Name","default":""}},"type":"object","title":"AccountKeyCreate"},"AdminKeyCreate":{"properties":{"name":{"type":"string","title":"Name"},"email":{"type":"string","title":"Email","default":""},"tier":{"type":"string","title":"Tier","default":"dev"},"daily":{"type":"integer","title":"Daily","default":2000}},"type":"object","required":["name"],"title":"AdminKeyCreate"},"AdminKeyPatch":{"properties":{"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"dailyLimit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dailylimit"},"tier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tier"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"}},"type":"object","title":"AdminKeyPatch"},"BugReport":{"properties":{"message":{"type":"string","title":"Message"},"url":{"type":"string","title":"Url","default":""},"ticker":{"type":"string","title":"Ticker","default":""}},"type":"object","required":["message"],"title":"BugReport"},"CheckSourcesBody":{"properties":{"ticker":{"type":"string","title":"Ticker","default":""},"accession":{"type":"string","title":"Accession","default":""},"cells":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Cells","default":[]}},"type":"object","title":"CheckSourcesBody"},"ContactBody":{"properties":{"email":{"type":"string","title":"Email","default":""},"company":{"type":"string","title":"Company","default":""},"message":{"type":"string","title":"Message","default":""}},"type":"object","title":"ContactBody"},"CopilotLocateBody":{"properties":{"slots":{"items":{"type":"string"},"type":"array","title":"Slots","default":[]},"tables":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tables","default":[]}},"type":"object","title":"CopilotLocateBody"},"DecisionBody":{"properties":{"context":{"type":"string","title":"Context","default":"retrofit"},"row_label":{"type":"string","title":"Row Label","default":""},"decision":{"type":"string","title":"Decision","default":"refused"},"series_id":{"type":"string","title":"Series Id","default":""},"accession":{"type":"string","title":"Accession","default":""},"table_id":{"type":"string","title":"Table Id","default":""}},"type":"object","title":"DecisionBody"},"ExcelAgentBody":{"properties":{"messages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Messages","default":[]}},"type":"object","title":"ExcelAgentBody"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KpiSeriesBody":{"properties":{"concept":{"type":"string","title":"Concept"},"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"dims":{"anyOf":[{"items":{"items":{"type":"string"},"type":"array"},"type":"array"},{"type":"null"}],"title":"Dims"},"form":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Form"}},"type":"object","required":["concept"],"title":"KpiSeriesBody"},"KpiTrackBody":{"properties":{"ticker":{"type":"string","title":"Ticker"},"concept":{"type":"string","title":"Concept"},"label":{"type":"string","title":"Label","default":""},"source":{"type":"string","title":"Source","default":""},"kind":{"type":"string","title":"Kind","default":"tag"}},"type":"object","required":["ticker","concept"],"title":"KpiTrackBody","description":"One item the analyst chose to follow. `kind` is the grain: a tagged LINE\n(`tag`, anchor = the XBRL concept) or a whole TABLE (`table`, anchor = the\nfiler's presentation-role id). `concept` holds whichever anchor the grain\nuses; `label` is the wording it was tracked under (the drift baseline);\n`source` is which path answered its history (\"companyfacts\" | \"filings\")."},"LabelBody":{"properties":{"sheet":{"type":"string","title":"Sheet"},"mode":{"type":"string","title":"Mode","default":"annual"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items","default":[]}},"type":"object","required":["sheet"],"title":"LabelBody"},"LabelVariantsBody":{"properties":{"concepts":{"items":{"type":"string"},"type":"array","title":"Concepts","default":[]}},"type":"object","title":"LabelVariantsBody"},"LinkTokenBody":{"properties":{"ttl_s":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ttl S"}},"type":"object","title":"LinkTokenBody"},"OrgInvite":{"properties":{"email":{"type":"string","title":"Email","default":""}},"type":"object","title":"OrgInvite"},"PairSuggestBody":{"properties":{"rows":{"items":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}]},"type":"array","title":"Rows","default":[]},"lines":{"items":{"anyOf":[{"type":"string"},{"additionalProperties":true,"type":"object"}]},"type":"array","title":"Lines","default":[]}},"type":"object","title":"PairSuggestBody","description":"Two lists of ENTRIES, one per row on each side.\n\nAn entry is either a bare label or `{label, values, periods, section, depth,\nbold}` — the line as the filer PRINTED it, which is what `pair_suggest._entry`\nrenders into the prompt. This used to be `list[str]`, and when the pane\nstarted sending the richer entry (part 14 — a line read IN its table, with\nits section, its indentation and its figures) every call came back 422 and\nthe whole AI tier was off. `pair_suggest` has always accepted both shapes;\nonly this schema disagreed.\n\nThe model still answers in INDEXES into these two lists and authors nothing\n— the figures ride along so it can compare like with like, exactly as an\nanalyst control-Fs a value across the two documents."},"RetrofitBody":{"properties":{"rows":{"items":{"$ref":"#/components/schemas/RetrofitRow"},"type":"array","title":"Rows","default":[]},"cap":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cap"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"prose":{"type":"boolean","title":"Prose","default":false}},"type":"object","title":"RetrofitBody"},"RetrofitRow":{"properties":{"label":{"type":"string","title":"Label","default":""},"values":{"items":{"type":"number"},"type":"array","title":"Values","default":[]},"concept":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Concept"}},"type":"object","title":"RetrofitRow"},"SegmentAiBody":{"properties":{"request":{"type":"string","title":"Request"},"accession":{"type":"string","title":"Accession"},"tableId":{"type":"string","title":"Tableid"}},"type":"object","required":["request","accession","tableId"],"title":"SegmentAiBody"},"SeriesConfirmBody":{"properties":{"ticker":{"type":"string","title":"Ticker"},"concept":{"type":"string","title":"Concept","default":""},"dims":{"anyOf":[{"items":{"items":{"type":"string"},"type":"array"},"type":"array"},{"type":"null"}],"title":"Dims"},"form":{"type":"string","title":"Form","default":"10-K"},"statement":{"type":"string","title":"Statement","default":""},"canonical_label":{"type":"string","title":"Canonical Label","default":""},"last_seen_period":{"type":"string","title":"Last Seen Period","default":""},"anchor_kind":{"type":"string","title":"Anchor Kind","default":"concept"},"heading":{"type":"string","title":"Heading","default":""},"fp_values":{"items":{"type":"number"},"type":"array","title":"Fp Values","default":[]},"workbook_key":{"type":"string","title":"Workbook Key","default":""},"sheet_name":{"type":"string","title":"Sheet Name","default":""},"row":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Row"},"reported_label":{"type":"string","title":"Reported Label","default":""},"unit_scale":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Unit Scale","default":1},"sign_conv":{"type":"string","title":"Sign Conv","default":""},"confidence":{"type":"number","title":"Confidence","default":0.0},"match_basis":{"type":"string","title":"Match Basis","default":""},"source_anchor":{"type":"string","title":"Source Anchor","default":""},"sign_convention":{"type":"number","title":"Sign Convention","default":1},"mapping_detail":{"additionalProperties":true,"type":"object","title":"Mapping Detail","default":{}}},"type":"object","required":["ticker"],"title":"SeriesConfirmBody"},"SeriesIdBody":{"properties":{"series_id":{"type":"string","title":"Series Id"}},"type":"object","required":["series_id"],"title":"SeriesIdBody"},"StyleDefaultBody":{"properties":{"spec":{"additionalProperties":true,"type":"object","title":"Spec","default":{}}},"type":"object","title":"StyleDefaultBody"},"SuggestBody":{"properties":{"sheet":{"type":"string","title":"Sheet"},"mode":{"type":"string","title":"Mode","default":"annual"}},"type":"object","required":["sheet"],"title":"SuggestBody"},"TabAiBody":{"properties":{"request":{"type":"string","title":"Request"},"tables":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Tables","default":[]}},"type":"object","required":["request"],"title":"TabAiBody"},"TabBody":{"properties":{"accession":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Accession"},"tableId":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tableid"},"table":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Table"},"topic":{"type":"string","title":"Topic"},"metrics":{"items":{"type":"string"},"type":"array","title":"Metrics","default":[]},"totalLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Totallabel"},"denomLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Denomlabel"}},"type":"object","required":["topic"],"title":"TabBody"},"TabScoutBody":{"properties":{"sheet":{"type":"string","title":"Sheet","default":""},"fields":{"items":{},"type":"array","title":"Fields","default":[]},"snapshot":{"additionalProperties":true,"type":"object","title":"Snapshot","default":{}}},"type":"object","title":"TabScoutBody"},"V1VerifyBody":{"properties":{"ticker":{"type":"string","title":"Ticker"},"claim":{"type":"string","title":"Claim","default":""},"metric":{"type":"string","title":"Metric","default":""},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"period":{"type":"string","title":"Period","default":""},"forms":{"type":"string","title":"Forms","default":""}},"type":"object","required":["ticker"],"title":"V1VerifyBody"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyLandedBody":{"properties":{"cells":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Cells","default":[]}},"type":"object","title":"VerifyLandedBody"}}},"paths":{"/v1/health":{"get":{"summary":"Health","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/history":{"get":{"summary":"V1 History","operationId":"v1_history_v1_history_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":40,"title":"Limit"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tickers":{"get":{"summary":"V1 Tickers","operationId":"v1_tickers_v1_tickers_get","deprecated":true,"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":1000,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{ticker}/{accession}/tables":{"get":{"summary":"V1 Filing Tables","operationId":"v1_filing_tables_v1_filings__ticker___accession__tables_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{ticker}/{accession}/prose":{"get":{"summary":"V1 Filing Prose","operationId":"v1_filing_prose_v1_filings__ticker___accession__prose_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"","title":"Source"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/search":{"get":{"summary":"V1 Search","description":"Door 1 of 5: one search over rows, tables, and prose — one envelope\n(data + provenance + pagination + links), one cell shape.","operationId":"v1_search_v1_search_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Type"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{ticker}":{"get":{"summary":"V1 Filings","description":"Door 2: the ticker's filings, filterable, each with its links.","operationId":"v1_filings_v1_filings__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"form","in":"query","required":false,"schema":{"type":"string","default":"","title":"Form"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"year","in":"query","required":false,"schema":{"type":"string","default":"","title":"Year"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{ticker}/{accession}":{"get":{"summary":"V1 Filing","description":"Door 3: one filing object; ?include=tables,prose,exhibits expands it.","operationId":"v1_filing_v1_filings__ticker___accession__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"include","in":"query","required":false,"schema":{"type":"string","default":"","title":"Include"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trace/{trace_id}":{"get":{"summary":"V1 Trace","description":"Door 5: the exact printed source behind any value this API returned.\n`?include=context` also serves each cell trace's printed neighbour rows,\nso a receipt drawer renders from one call.","operationId":"v1_trace_v1_trace__trace_id__get","parameters":[{"name":"trace_id","in":"path","required":true,"schema":{"type":"string","title":"Trace Id"}},{"name":"include","in":"query","required":false,"schema":{"type":"string","default":"","title":"Include"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/verify":{"post":{"summary":"V1 Verify","description":"Door 6: prove a financial claim against what the filings print.\nDeterministic end to end — verdicts are supported / unsupported (with what\nthe filing prints instead) / ambiguous (all receipts) / unavailable (the\nindex could not answer; never mistaken for unsupported).","operationId":"v1_verify_v1_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1VerifyBody"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tools/search":{"get":{"summary":"V1 Tools Search","description":"One Research run: /v1/search under the tool-run price.","operationId":"v1_tools_search_v1_tools_search_get","deprecated":true,"parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","default":"all","title":"Type"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/prose/search":{"get":{"summary":"V1 Prose Search","operationId":"v1_prose_search_v1_prose_search_get","deprecated":true,"parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"","title":"Source"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}},{"name":"order","in":"query","required":false,"schema":{"type":"string","default":"relevance","title":"Order"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rows/search":{"get":{"summary":"V1 Rows Search","operationId":"v1_rows_search_v1_rows_search_get","deprecated":true,"parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"","title":"Source"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tables/search":{"get":{"summary":"V1 Tables Search","operationId":"v1_tables_search_v1_tables_search_get","deprecated":true,"parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"start_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"Start Date"}},{"name":"end_date","in":"query","required":false,"schema":{"type":"string","default":"","title":"End Date"}},{"name":"forms","in":"query","required":false,"schema":{"type":"string","default":"","title":"Forms"}},{"name":"source","in":"query","required":false,"schema":{"type":"string","default":"","title":"Source"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tables/{ticker}/{accession}/{table_id}":{"get":{"summary":"V1 Full Table","description":"Door 4: the printed table — grid | records | csv, in the envelope.","operationId":"v1_full_table_v1_tables__ticker___accession___table_id__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"table_id","in":"path","required":true,"schema":{"type":"string","title":"Table Id"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"grid","title":"Format"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tables/{ticker}/{accession}/{table_id}/xlsx":{"get":{"summary":"V1 Table Xlsx","operationId":"v1_table_xlsx_v1_tables__ticker___accession___table_id__xlsx_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"table_id","in":"path","required":true,"schema":{"type":"string","title":"Table Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"summary":"V1 Me","description":"Your key, its cap, and today's usage.","operationId":"v1_me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/coverage":{"get":{"summary":"V1 Coverage","description":"What the read path can serve, and how fresh — one honest coverage door.\nPass `ticker` for one issuer; omit for the index summary. Supersedes the\ndeprecated /v1/tickers, /v1/status, /v1/stats.","operationId":"v1_coverage_v1_coverage_get","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"type":"string","default":"","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stats":{"get":{"summary":"V1 Stats","description":"PUBLIC warehouse totals for the homepage strip — live counts from the\nwarehouse_stats() SQL function (cheap exact counts + planner estimates for\nthe 29M-row tables), cached an hour.","operationId":"v1_stats_v1_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"deprecated":true}},"/v1/status":{"get":{"summary":"V1 Status","description":"Index freshness: catalog version, totals, latest filed date.","operationId":"v1_status_v1_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"deprecated":true}},"/v1/changes":{"get":{"summary":"V1 Changes","description":"Filings (re)indexed since a timestamp — the sync-polling hook.","operationId":"v1_changes_v1_changes_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"type":"string","default":"","title":"Since"}},{"name":"ticker","in":"query","required":false,"schema":{"type":"string","default":"","title":"Ticker"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/forms":{"get":{"summary":"V1 Forms","description":"Which filing types the index holds for this ticker.","operationId":"v1_forms_v1_forms_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/periods":{"get":{"summary":"V1 Periods","description":"The years this ticker's data actually covers — year-dropdown fuel.","operationId":"v1_periods_v1_periods_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/labels":{"get":{"summary":"V1 Labels","description":"Autocomplete over the filer's own row captions (prefix match).","operationId":"v1_labels_v1_labels_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/labels/variants":{"get":{"summary":"V1 Label Variants","description":"Every distinct caption CONTAINING q, with counts and filed span — see\nexactly how the filer's wording varies before you query it.","operationId":"v1_label_variants_v1_labels_variants_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/labels/history":{"get":{"summary":"V1 Label History","description":"One line's printed history across every filing, by the filer's own\ncaption — each value traced and viewer-linked.","operationId":"v1_label_history_v1_labels_history_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"label","in":"query","required":true,"schema":{"type":"string","title":"Label"}},{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/headings":{"get":{"summary":"V1 Headings","description":"Distinct table headings across this ticker's filings.","operationId":"v1_headings_v1_headings_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"q","in":"query","required":false,"schema":{"type":"string","default":"","title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/filings/{ticker}/{accession}/exhibits":{"get":{"summary":"V1 Filing Exhibits","description":"The filing's exhibits that carry tables, with their table ids.","operationId":"v1_filing_exhibits_v1_filings__ticker___accession__exhibits_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tables/{ticker}/{accession}/{table_id}/periods":{"get":{"summary":"V1 Table Periods","description":"A table's printed period headers, exactly as filed.","operationId":"v1_table_periods_v1_tables__ticker___accession___table_id__periods_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"table_id","in":"path","required":true,"schema":{"type":"string","title":"Table Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tables/{ticker}/{accession}/{table_id}/same-in":{"get":{"summary":"V1 Same Table In","description":"Carry an identified table to other filings (comma-separated target\naccessions) by its printed heading — the time-series continuity call.","operationId":"v1_same_table_in_v1_tables__ticker___accession___table_id__same_in_get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"path","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"table_id","in":"path","required":true,"schema":{"type":"string","title":"Table Id"}},{"name":"targets","in":"query","required":true,"schema":{"type":"string","title":"Targets"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/statements":{"get":{"summary":"V1 Statements","description":"Candidate tables for a named statement (pl / bs / cf) in one filing —\na recommendation to verify against the heading, never an answer.","operationId":"v1_statements_v1_statements_get","parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"query","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"statement","in":"query","required":true,"schema":{"type":"string","title":"Statement"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/find":{"get":{"summary":"V1 Find","description":"Locate specific values or labels inside one filing (comma/newline-\nseparated queries).","operationId":"v1_find_v1_find_get","deprecated":true,"parameters":[{"name":"ticker","in":"query","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"accession","in":"query","required":true,"schema":{"type":"string","title":"Accession"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/trace":{"get":{"summary":"V1 Trace Query","description":"Deprecated alias of GET /v1/trace/{traceId}. Reopens cells AND passages\nthrough the one canonical trace implementation; comma-separated ids ok.","operationId":"v1_trace_query_v1_trace_get","deprecated":true,"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","title":"Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}