{"components":{"schemas":{"Addresses":{"properties":{"business":{"description":"{street1, street2, city, state, zip, phone} as filed.","type":["object","null"]},"mail":{"type":["object","null"]}},"type":"object"},"Coverage":{"properties":{"data":{"description":"Per feed day, the latest non-superseded ingest run; newest day first. At most window.max_days days: the newest ones of the window. Recomputed at most once a minute per window.","items":{"$ref":"#/components/schemas/CoverageDay"},"type":"array"},"snapshot":{"description":"The snapshot store and the snapshot it serves.","properties":{"accessions":{"description":"Distinct filings in the snapshot.","type":["integer","null"]},"age_days":{"type":["integer","null"]},"available":{"type":"boolean"},"date":{"$ref":"#/components/schemas/NullableDate"},"fallback":{"description":"A newer snapshot exists but could not be loaded.","type":["boolean","null"]},"filers":{"type":["integer","null"]},"filings":{"description":"Filing listings in the snapshot (a filing listed by two filers counts twice).","type":["integer","null"]},"loaded_at":{"$ref":"#/components/schemas/NullableTime"},"reloading":{"description":"A newer snapshot is being loaded; the current one keeps serving.","type":["boolean","null"]},"stale":{"description":"The snapshot is more than 3 days old.","type":["boolean","null"]},"state":{"enum":["ok","stale","loading","unavailable","disabled"],"type":"string"},"tickers_date":{"$ref":"#/components/schemas/NullableDate","description":"Newest copy of SEC's ticker file."},"tickers_from":{"$ref":"#/components/schemas/NullableDate","description":"Oldest copy kept."}},"type":"object"},"totals":{"description":"Table-wide totals, whatever the window; recomputed at most once a minute. When a recomputation fails the previous totals keep being served.","properties":{"accepted_at_stored":{"description":"Filings with an acceptance time stored in v3 (learned live). The snapshot supplies the others.","type":"integer"},"amendments":{"description":"Amendments, deleted ones excluded.","type":"integer"},"amendments_resolved":{"description":"Of those amendments, the ones linked to their original.","type":"integer"},"deleted_filings":{"type":"integer"},"documents":{"type":"integer"},"filings":{"type":"integer"},"max_feed_date":{"$ref":"#/components/schemas/NullableDate"},"max_filing_date":{"$ref":"#/components/schemas/NullableDate"},"min_feed_date":{"$ref":"#/components/schemas/NullableDate"},"min_filing_date":{"$ref":"#/components/schemas/NullableDate"}},"type":"object"},"truncated":{"description":"True when the window holds more feed days than max_days: the older ones are left out. Ask for them with from / to.","type":"boolean"},"window":{"description":"The window of feed days this answer covers.","properties":{"default":{"description":"True when neither from nor to was given: the last 90 feed days.","type":"boolean"},"from":{"$ref":"#/components/schemas/NullableDate","description":"The from that was asked for; without one, the oldest day listed (null when no day is listed)."},"max_days":{"description":"The most days one answer lists: 90 for the default window, 366 when from or to is given.","type":"integer"},"to":{"$ref":"#/components/schemas/NullableDate","description":"The to that was asked for; without one, the newest day listed (null when no day is listed)."}},"type":"object"}},"required":["data","window","truncated","totals","snapshot"],"type":"object"},"CoverageDay":{"properties":{"day":{"$ref":"#/components/schemas/Date"},"filings":{"description":"Filings whose feed_date is this day.","type":"integer"},"finished_at":{"$ref":"#/components/schemas/NullableTime"},"members_failed":{"type":"integer"},"members_ok":{"type":"integer"},"members_skipped":{"type":"integer"},"members_total":{"type":"integer"},"reconciliation":{"description":"The newest complete reconcile run of the day (a later partial run does not replace it); null when the day has none.","properties":{"chains_deferred":{"description":"Filings whose version chain was still waiting to be re-ordered with snapshot acceptance times when the run ended; 0 when none.","type":"integer"},"finished_at":{"$ref":"#/components/schemas/NullableTime"},"outcomes":{"additionalProperties":{"additionalProperties":{"type":"integer"},"type":"object"},"description":"check name → outcome → row count.","type":"object"},"run_id":{"type":"integer"},"status":{"description":"Both comparisons (SEC daily index, submissions snapshot) ran. It does not say that the order of version chains is final: see chains_deferred.","enum":["complete"],"type":"string"}},"type":["object","null"]},"run_id":{"type":"integer"},"started_at":{"$ref":"#/components/schemas/NullableTime"},"status":{"enum":["running","complete","partial","source_invalid","failed"],"type":"string"}},"type":"object"},"Date":{"format":"date","type":"string"},"Document":{"properties":{"decode_status":{"enum":["ok","repaired","failed"],"type":"string"},"description":{"type":["string","null"]},"encoding":{"enum":["text","uu","base64"],"type":"string"},"filename":{"type":"string"},"is_primary":{"type":"boolean"},"mime":{"type":"string"},"seq":{"type":"integer"},"sha256":{"description":"Hex SHA-256 of the stored bytes; also the ETag.","type":["string","null"]},"size_bytes":{"type":["integer","null"]},"type":{"type":"string"},"url":{"type":"string"}},"type":"object"},"DocumentList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Document"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["data"],"type":"object"},"Entity":{"description":"Most recent as-filed attributes of a CIK, plus SEC's current entity record. When the snapshot store is unavailable and v3 has no filing for the CIK, nothing can be said about it: the body is then only {cik, data: null, snapshot}.","properties":{"addresses":{"$ref":"#/components/schemas/Addresses"},"as_of":{"description":"The filing the as-filed attributes come from; null when v3 has no filing for the CIK.","properties":{"accession":{"type":"string"},"filing_date":{"$ref":"#/components/schemas/Date"},"role":{"type":"string"}},"type":["object","null"]},"cik":{"type":"string"},"current":{"$ref":"#/components/schemas/EntityCurrent"},"data":{"description":"Present (null) only in the {cik, data, snapshot} body described above.","type":"null"},"filings":{"description":"Filings in v3 that name the entity.","type":"integer"},"first_filing_date":{"$ref":"#/components/schemas/NullableDate"},"fiscal_year_end":{"type":["string","null"]},"former_names":{"items":{"type":"object"},"type":"array"},"irs_number":{"type":["string","null"]},"last_filing_date":{"$ref":"#/components/schemas/NullableDate"},"links":{"properties":{"filings":{"type":"string"},"sec_filings":{"type":"string"},"self":{"type":"string"}},"type":"object"},"name":{"type":["string","null"]},"role_counts":{"additionalProperties":{"type":"integer"},"type":"object"},"roles":{"items":{"type":"string"},"type":"array"},"sic":{"type":["string","null"]},"snapshot":{"$ref":"#/components/schemas/Snapshot"},"state_of_inc":{"type":["string","null"]}},"type":"object"},"EntityCurrent":{"description":"SEC's entity record from the submissions snapshot; null when the snapshot has no such CIK or is unavailable (see snapshot.available).","properties":{"addresses":{"$ref":"#/components/schemas/Addresses"},"category":{"type":["string","null"]},"cik":{"type":"string"},"ein":{"type":["string","null"]},"entity_type":{"type":["string","null"]},"exchanges":{"items":{"type":"string"},"type":"array"},"filings":{"description":"Filings in SEC's list for the entity.","type":"integer"},"first_filing_date":{"$ref":"#/components/schemas/NullableDate"},"fiscal_year_end":{"type":["string","null"]},"flags":{"type":["string","null"]},"former_names":{"items":{"type":"object"},"type":"array"},"last_filing_date":{"$ref":"#/components/schemas/NullableDate"},"lei":{"type":["string","null"]},"listed":{"description":"The entity's rows in SEC's ticker file: {ticker, exchange}.","items":{"type":"object"},"type":"array"},"listed_as_of":{"$ref":"#/components/schemas/NullableDate"},"name":{"type":"string"},"phone":{"type":["string","null"]},"sic":{"type":["string","null"]},"sic_description":{"type":["string","null"]},"state_of_inc":{"type":["string","null"]},"ticker_exchanges":{"items":{"type":"object"},"type":"array"},"tickers":{"items":{"type":"string"},"type":"array"}},"type":["object","null"]},"EntityList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/EntityMatch"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"snapshot":{"$ref":"#/components/schemas/Snapshot","description":"available is true when the snapshot was searched; false when the list is names as filed."}},"required":["data","snapshot"],"type":"object"},"EntityMatch":{"properties":{"cik":{"type":"string"},"filings":{"description":"Filings in v3 that name the entity.","type":"integer"},"matched":{"description":"What the query matched. Snapshot search results only.","enum":["cik","ticker","name","former_name"],"type":"string"},"name":{"description":"SEC's current name (snapshot search) or the most recent name as filed.","type":["string","null"]},"sec_filings":{"description":"Filings in SEC's list for the entity. Snapshot search results only.","type":"integer"},"tickers":{"description":"Snapshot search results only.","items":{"type":"string"},"type":"array"}},"type":"object"},"Event":{"properties":{"at":{"format":"date-time","type":"string"},"details":{"type":"object"},"event":{"type":"string"},"seq":{"type":"integer"},"source":{"type":"string"}},"type":"object"},"EventList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Event"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["data"],"type":"object"},"Filing":{"properties":{"accepted_at":{"$ref":"#/components/schemas/NullableTime","description":"SEC's snapshot value when the snapshot lists the filing (even if v3 stores a different one), otherwise the value stored in v3, otherwise null."},"accepted_at_source":{"description":"submissions: from the snapshot. The others: how v3 learned the stored value.","enum":["submissions","realtime","archives_txt","oldload",null],"type":["string","null"]},"accession":{"pattern":"^[0-9]{10}-[0-9]{2}-[0-9]{6}$","type":"string"},"base_form":{"type":"string"},"doc_count":{"type":"integer"},"feed_date":{"$ref":"#/components/schemas/NullableDate"},"filing_date":{"$ref":"#/components/schemas/Date"},"form_type":{"description":"Form type as filed.","type":"string"},"is_amendment":{"type":"boolean"},"items":{"items":{"type":"string"},"type":"array"},"links":{"properties":{"documents":{"type":"string"},"events":{"type":"string"},"header":{"type":"string"},"self":{"type":"string"}},"type":"object"},"period_of_report":{"$ref":"#/components/schemas/NullableDate","description":"SEC's snapshot value (reportDate) when the snapshot lists the filing and gives one, otherwise the value in the filing's header."},"period_of_report_source":{"enum":["submissions","header",null],"type":["string","null"]},"primary_cik":{"pattern":"^[0-9]{10}$","type":"string"},"primary_name":{"description":"Name of the primary entity as filed.","type":["string","null"]},"sec_url":{"format":"uri","type":"string"},"source":{"enum":["feed","oldload","archives","realtime"],"type":"string"},"status":{"enum":["provisional","final","deleted"],"type":"string"},"total_bytes":{"type":"integer"}},"required":["accession","form_type","base_form","is_amendment","filing_date","status","primary_cik","sec_url","links"],"type":"object"},"FilingDetail":{"allOf":[{"$ref":"#/components/schemas/Filing"},{"properties":{"date_of_change":{"$ref":"#/components/schemas/NullableDate"},"deleted":{"type":"boolean"},"deleted_at":{"$ref":"#/components/schemas/NullableTime"},"documents":{"items":{"$ref":"#/components/schemas/Document"},"type":"array"},"effectiveness_date":{"$ref":"#/components/schemas/NullableDate"},"entities":{"items":{"$ref":"#/components/schemas/FilingEntity"},"type":"array"},"events":{"items":{"$ref":"#/components/schemas/Event"},"type":"array"},"finalized_at":{"$ref":"#/components/schemas/NullableTime"},"first_seen_at":{"$ref":"#/components/schemas/NullableTime"},"is_correction":{"type":"boolean"},"is_paper":{"type":"boolean"},"is_private_release":{"type":"boolean"},"items_unmapped":{"items":{"type":"string"},"type":"array"},"previous_accession":{"type":["string","null"]},"released_at":{"$ref":"#/components/schemas/NullableTime"},"snapshot":{"$ref":"#/components/schemas/Snapshot"},"versions":{"$ref":"#/components/schemas/Versions"}},"type":"object"}]},"FilingEntity":{"properties":{"addresses":{"$ref":"#/components/schemas/Addresses"},"cik":{"type":"string"},"file_number":{"type":["string","null"]},"film_number":{"type":["string","null"]},"fiscal_year_end":{"type":["string","null"]},"name":{"type":["string","null"]},"role":{"enum":["filer","subject","filed_by","filed_for","reporting_owner","issuer"],"type":"string"},"sic":{"type":["string","null"]},"state_of_inc":{"type":["string","null"]}},"type":"object"},"FilingList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Filing"},"type":"array"},"has_more":{"description":"With sort=accepted_at and no cik a page can hold fewer rows than limit (even none) and still have more: follow next_cursor until has_more is false. With cik (and at most 10,000 matching filings) pages are complete and has_more is exact.","type":"boolean"},"next_cursor":{"type":["string","null"]},"snapshot":{"$ref":"#/components/schemas/Snapshot"}},"required":["data","has_more","next_cursor","snapshot"],"type":"object"},"FormCount":{"properties":{"base_form":{"type":"string"},"count":{"type":"integer"},"form_type":{"type":"string"},"is_amendment":{"type":"boolean"}},"type":"object"},"FormList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/FormCount"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]}},"required":["data"],"type":"object"},"Health":{"properties":{"checks":{"properties":{"db":{"enum":["ok","fail"],"type":"string"},"docs_root":{"enum":["ok","missing"],"type":"string"},"store":{"description":"The snapshot store. stale: its snapshot is more than 3 days old (still used). loading: no snapshot served yet. disabled: not configured.","enum":["ok","stale","loading","unavailable","disabled"],"type":"string"}},"type":"object"},"status":{"description":"degraded unless every check is ok (a store that is not configured does not degrade). The HTTP status is 503 only when the database is down.","enum":["ok","degraded"],"type":"string"},"store":{"description":"The snapshot in use. Counts and load details are on /v3/coverage, which needs a key.","properties":{"available":{"type":"boolean"},"snapshot_date":{"$ref":"#/components/schemas/NullableDate"},"stale":{"type":["boolean","null"]}},"type":"object"},"time":{"format":"date-time","type":"string"},"version":{"type":"string"}},"required":["status","checks"],"type":"object"},"NullableDate":{"format":"date","type":["string","null"]},"NullableTime":{"description":"RFC 3339, UTC.","format":"date-time","type":["string","null"]},"OpenApi":{"description":"This document.","type":"object"},"Problem":{"description":"RFC 9457 problem details.","properties":{"code":{"enum":["invalid_parameter","unknown_parameter","unauthorized","not_found","gone","method_not_allowed","rate_limited","timeout","internal","db_unavailable","range_not_satisfiable","request_too_large","snapshot_unavailable"],"type":"string"},"detail":{"type":"string"},"parameter":{"description":"The offending parameter, for 400 responses.","type":"string"},"request_id":{"type":"string"},"status":{"type":"integer"},"title":{"type":"string"},"type":{"format":"uri","type":"string"}},"required":["type","title","status","detail","code","request_id"],"type":"object"},"Report":{"properties":{"amended":{"description":"True when any live member is an amendment.","type":"boolean"},"base_form":{"description":"Base form of the chain's head.","type":"string"},"cik":{"type":"string"},"first_filing_date":{"$ref":"#/components/schemas/NullableDate","description":"Filing date of the chain's head (the original, or the first ingested amendment when the original is absent)."},"head_is_amendment":{"description":"The chain's first listed filing is an amendment: its original is not ingested, or it is unlinked, unresolved or ambiguous.","type":"boolean"},"latest":{"properties":{"accepted_at":{"$ref":"#/components/schemas/NullableTime","description":"Merged like a filing's accepted_at."},"accepted_at_source":{"type":["string","null"]},"accession":{"type":"string"},"filing_date":{"$ref":"#/components/schemas/NullableDate"},"form_type":{"type":["string","null"]}},"type":"object"},"link_status":{"description":"Link status of the head when it is an amendment.","type":["string","null"]},"links":{"properties":{"latest":{"type":"string"},"versions":{"type":"string"}},"type":"object"},"original_ingested":{"description":"True only when the head is an ingested original (not an amendment).","type":"boolean"},"period_of_report":{"$ref":"#/components/schemas/NullableDate","description":"Period of the chain's head: SEC's snapshot value when the snapshot lists that filing and gives one, otherwise its header's. The period filter compares the header's value."},"period_of_report_source":{"enum":["submissions","header",null],"type":["string","null"]},"report_key":{"type":"string"},"versions":{"description":"Live (not deleted) ingested members; /versions count also includes deleted and not-ingested items.","type":"integer"}},"type":"object"},"ReportList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Report"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"snapshot":{"$ref":"#/components/schemas/Snapshot"}},"required":["data","has_more","next_cursor","snapshot"],"type":"object"},"ResolveMatch":{"properties":{"cik":{"type":"string"},"exchange":{"type":["string","null"]},"links":{"properties":{"entity":{"type":"string"},"filings":{"type":"string"}},"type":"object"},"name":{"type":["string","null"]},"ticker":{"type":"string"}},"type":"object"},"ResolveResult":{"properties":{"as_of":{"$ref":"#/components/schemas/NullableDate"},"coverage_from":{"$ref":"#/components/schemas/NullableDate","description":"The oldest copy kept; earlier dates cannot be resolved."},"data":{"items":{"$ref":"#/components/schemas/ResolveMatch"},"type":"array"},"file_date":{"$ref":"#/components/schemas/NullableDate","description":"The daily copy of SEC's ticker file that answered."},"has_more":{"type":"boolean"},"next_cursor":{"type":["string","null"]},"snapshot":{"$ref":"#/components/schemas/Snapshot","description":"available is false when the store could not be asked, or had neither a ticker file nor a snapshot to consult: empty data then means unknown, not that no entity holds the ticker."},"source":{"enum":["sec_company_tickers","submissions",null],"type":["string","null"]},"ticker":{"type":"string"}},"required":["ticker","data","snapshot"],"type":"object"},"SecFiling":{"description":"One filing as SEC lists it for the entity.","properties":{"accepted_at":{"$ref":"#/components/schemas/NullableTime"},"accession":{"type":"string"},"act":{"type":["string","null"]},"cik":{"type":"string"},"file_number":{"type":["string","null"]},"filing_date":{"$ref":"#/components/schemas/Date"},"film_number":{"type":["string","null"]},"form":{"type":"string"},"in_v3":{"description":"Whether v3 has ingested this filing.","type":"boolean"},"is_inline_xbrl":{"type":["boolean","null"]},"is_xbrl":{"type":["boolean","null"]},"items":{"items":{"type":"string"},"type":"array"},"links":{"properties":{"filing":{"description":"The filing in v3; null when in_v3 is false.","type":["string","null"]}},"type":"object"},"primary_doc_description":{"type":["string","null"]},"primary_document":{"type":["string","null"]},"report_date":{"$ref":"#/components/schemas/NullableDate"},"size":{"type":["integer","null"]}},"type":"object"},"SecFilingList":{"properties":{"data":{"items":{"$ref":"#/components/schemas/SecFiling"},"type":"array"},"has_more":{"type":"boolean"},"next_cursor":{"description":"Always null: this list is paged with offset; use next_offset.","type":["string","null"]},"next_offset":{"description":"The offset of the next page; null on the last page (and when the snapshot store is unavailable).","type":["integer","null"]},"offset":{"type":"integer"},"snapshot":{"$ref":"#/components/schemas/Snapshot"},"total":{"description":"Rows matching the filters; null when the snapshot store is unavailable.","type":["integer","null"]}},"required":["data","snapshot"],"type":"object"},"Snapshot":{"description":"Whether values from SEC's submissions snapshot (held in memory by the snapshot store) were available for this response. When available is false the response was built from the v3 database alone: acceptance times and report periods are the stored ones, and snapshot-only data is absent.","properties":{"available":{"type":"boolean"},"date":{"$ref":"#/components/schemas/NullableDate","description":"Date of the snapshot that was used; null when none was."}},"required":["available","date"],"type":"object"},"Versions":{"description":"Version chain of a report: the original and its amendments. A single-item chain when nothing is linked.","properties":{"count":{"description":"Members of the whole chain, deleted and not-ingested included.","type":"integer"},"items":{"items":{"properties":{"accepted_at":{"$ref":"#/components/schemas/NullableTime","description":"Merged like a filing's accepted_at; null for a member that is not ingested."},"accepted_at_source":{"type":["string","null"]},"accession":{"type":"string"},"amendment_no":{"type":["integer","null"]},"amendment_seq":{"description":"0 for the root, 1..n for amendments in filing order; null before the linker has numbered the chain.","type":["integer","null"]},"amendment_type":{"type":["string","null"]},"current":{"type":"boolean"},"filing_date":{"$ref":"#/components/schemas/NullableDate"},"form_type":{"type":["string","null"]},"ingested":{"description":"False for a root known only from an amendment's link.","type":"boolean"},"link":{"properties":{"candidates":{"description":"Possible originals, shown for an ambiguous link.","items":{"type":"object"},"type":"array"},"confidence":{"type":["number","null"]},"method":{"enum":["explicit_header","explicit_xml","original_date","period_match","date_items_match","file_number","description_text","manual",null],"type":["string","null"]},"status":{"enum":["resolved","ambiguous","unresolved","target_not_public","target_not_yet_ingested"],"type":"string"}},"type":"object"},"scope":{"type":["string","null"]},"status":{"type":["string","null"]}},"type":"object"},"type":"array"},"latest":{"description":"Newest ingested, non-deleted member.","type":"string"},"position":{"description":"1-based place of this filing in the whole chain (not in items when truncated).","type":"integer"},"report_key":{"description":"Accession of the chain's root (the original filing, even when it is not ingested).","type":"string"},"root":{"description":"Alias of report_key.","type":"string"},"snapshot":{"$ref":"#/components/schemas/Snapshot","description":"On /v3/filings/{accession}/versions only; the block embedded in a filing has none (the filing carries it)."},"truncated":{"description":"True when the chain has more than 200 members and items holds 200 of them (always the root, this filing and the latest, then the nearest to this filing).","type":"boolean"}},"type":"object"}},"securitySchemes":{"api_key_header":{"in":"header","name":"X-API-Key","type":"apiKey"},"api_key_query":{"description":"Least preferred: keys in URLs end up in logs.","in":"query","name":"api_key","type":"apiKey"},"bearer":{"description":"Authorization: Bearer <key> (preferred).","scheme":"bearer","type":"http"}}},"info":{"description":"Read-only API over the v3 core filing layer. Lists use the envelope {data, has_more, next_cursor}. Errors are RFC 9457 application/problem+json with a stable `code`. Unknown query parameters are rejected with 400. Every response carries X-Request-Id. HEAD and OPTIONS are answered for every path. Responses that can carry values from SEC's submissions snapshot (acceptance time, report period, entity records, SEC's filing lists, tickers) have a `snapshot` block {available, date}; when available is false the response was built from the v3 database alone.","title":"SecBlast v3 API (prototype)","version":"0.1.0"},"openapi":"3.1.0","paths":{"/v3/coverage":{"get":{"operationId":"get_coverage","parameters":[{"description":"First feed day (inclusive), YYYY-MM-DD. Default: see the description.","in":"query","name":"from","required":false,"schema":{"format":"date","type":"string"}},{"description":"Last feed day (inclusive), YYYY-MM-DD.","in":"query","name":"to","required":false,"schema":{"format":"date","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Coverage"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Ingest coverage: per feed day the latest non-superseded ingest run and the newest complete reconcile run, overall totals, and the snapshot store. Without from and to the last 90 feed days are listed; with either, the newest 366 feed days of that window at most (truncated says when days were left out, window what was used). The per-day part and the totals are each recomputed at most once a minute.","tags":["meta"]}},"/v3/entities":{"get":{"operationId":"get_entities","parameters":[{"description":"Name, ticker or CIK. Omit to list the most active entities as filed (of the last 30 days of filings).","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Maximum results, 1..50.","in":"query","name":"limit","required":false,"schema":{"default":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EntityList"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Entity search. With q: SEC's snapshot is searched by current and former name, ticker and CIK (snapshot.available=true). When the snapshot store is unavailable: names as filed containing q, or CIKs starting with q. Without q: the most active entities as filed. Those two answers come from v3's own filings and look only at filings filed in the 30 days up to the newest filing date in v3 (most active = named by most filings of those days); an entity seen only in older filings is not listed. filings is always the entity's whole count in v3.","tags":["entities"]}},"/v3/entities/{cik}":{"get":{"operationId":"get_entities__cik_","parameters":[{"description":"CIK, padded or unpadded.","in":"path","name":"cik","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Entity"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Most recent as-filed attributes of a CIK, SEC's current entity record from the snapshot (current), roles seen and filing counts. 404 when neither v3 nor the snapshot knows the CIK; when this deployment has no snapshot store configured, 404 whenever v3 has no filing for the CIK (v3 is then the only source). When a configured snapshot store is unavailable and v3 has no filing for the CIK the answer is 200 {cik, data: null, snapshot}: it cannot be told.","tags":["entities"]}},"/v3/entities/{cik}/filings":{"get":{"operationId":"get_entities__cik__filings","parameters":[{"description":"CIK, padded or unpadded.","in":"path","name":"cik","required":true,"schema":{"type":"string"}},{"description":"Exact form type(s), e.g. 10-K or 8-K,8-K/A.","explode":false,"in":"query","name":"form","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"filing_date >= this date (inclusive).","in":"query","name":"filed_from","required":false,"schema":{"format":"date","type":"string"}},{"description":"filing_date <= this date (inclusive).","in":"query","name":"filed_to","required":false,"schema":{"format":"date","type":"string"}},{"description":"Page size, 1..1000.","in":"query","name":"limit","required":false,"schema":{"default":50,"type":"integer"}},{"description":"Rows to skip, 0..100000000.","in":"query","name":"offset","required":false,"schema":{"default":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SecFilingList"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"SEC's own filing list for the entity (from the submissions snapshot), newest first; each row says whether v3 has the filing. 404 when the snapshot has no such CIK. Empty data with snapshot.available=false when the snapshot store is unavailable. Paged with offset (pass next_offset back as offset; next_cursor is always null): the list can shift when a new snapshot is loaded.","tags":["entities"]}},"/v3/filings":{"get":{"operationId":"get_filings","parameters":[{"description":"CIK in any entity role, padded or unpadded. Combined with role and q on the same entity.","in":"query","name":"cik","required":false,"schema":{"type":"string"}},{"description":"Entity role to match (with cik and/or q, or alone). Without cik it requires filed_from and filed_to at most 92 days apart (400 otherwise).","in":"query","name":"role","required":false,"schema":{"enum":["filer","subject","filed_by","reporting_owner","issuer","filed_for"],"type":"string"}},{"description":"Base form(s), exact, e.g. 10-K or 8-K,10-Q. Matches amendments too unless amendments=exclude.","explode":false,"in":"query","name":"form","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Whether to include amendments.","in":"query","name":"amendments","required":false,"schema":{"default":"include","enum":["include","exclude","only"],"type":"string"}},{"description":"Exact form type(s) as filed, e.g. 10-K/A.","explode":false,"in":"query","name":"form_type","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"filing_date >= this date (inclusive).","in":"query","name":"filed_from","required":false,"schema":{"format":"date","type":"string"}},{"description":"filing_date <= this date (inclusive).","in":"query","name":"filed_to","required":false,"schema":{"format":"date","type":"string"}},{"description":"feed_date >= this date (inclusive).","in":"query","name":"feed_from","required":false,"schema":{"format":"date","type":"string"}},{"description":"feed_date <= this date (inclusive).","in":"query","name":"feed_to","required":false,"schema":{"format":"date","type":"string"}},{"description":"Item codes (e.g. 2.02,9.01); a filing matches when it has any of them.","explode":false,"in":"query","name":"items","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Filing status. Default: every status except deleted.","in":"query","name":"status","required":false,"schema":{"enum":["provisional","final","deleted"],"type":"string"}},{"description":"Acceptance time >= this: YYYY-MM-DDTHH:MM:SSZ (UTC) or YYYY-MM-DD. Requires sort=accepted_at.","in":"query","name":"accepted_from","required":false,"schema":{"type":"string"}},{"description":"Acceptance time <= this (inclusive; a date means the whole UTC day): YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD. Requires sort=accepted_at.","in":"query","name":"accepted_to","required":false,"schema":{"type":"string"}},{"description":"Case-insensitive substring of an entity name as filed. Without cik it requires filed_from and filed_to at most 92 days apart (400 otherwise): the name is tested filing by filing.","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Sort key (ties broken by accession).","in":"query","name":"sort","required":false,"schema":{"default":"filing_date","enum":["filing_date","accession","accepted_at"],"type":"string"}},{"description":"Sort direction.","in":"query","name":"order","required":false,"schema":{"default":"desc","enum":["desc","asc"],"type":"string"}},{"description":"Page size, 1..1000.","in":"query","name":"limit","required":false,"schema":{"default":50,"type":"integer"}},{"description":"Opaque cursor from a previous page's next_cursor. Must be used with the same filters, sort and order.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingList"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable (code db_unavailable); or, for a sort=accepted_at cursor issued with snapshot times, the snapshot store is unavailable (code snapshot_unavailable). Retry the same request after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Search filings. Keyset pagination: pass next_cursor back as cursor with the same filters and sort. Deleted filings are listed only with status=deleted. q and role need cik or a filing-date window (filed_from and filed_to, at most 92 days apart): 400 otherwise. sort=accepted_at lists filings by acceptance time (SEC's snapshot value, or the stored one for filings the snapshot does not list yet); filings without one are not listed. With cik (and at most 10,000 filings of that entity matching the other filters) the entity's filings are read directly: pages are complete and has_more is exact. Without cik, or above that number, SEC's time index is walked (at most 40,000 of its filings per request): a page may then be shorter than limit, even empty, while has_more is true; narrow it with accepted_from / accepted_to. When the snapshot store is unavailable on the first page (snapshot.available=false) the listing holds only filings with a stored time and its cursors stay in that mode. A cursor of a listing built with snapshot times cannot be continued while the store is unavailable: 503 with code snapshot_unavailable and Retry-After; retry the same request.","tags":["filings"]}},"/v3/filings/{accession}":{"get":{"operationId":"get_filings__accession_","parameters":[{"description":"Accession number, with dashes (0001829126-26-010431) or without (18 digits).","in":"path","name":"accession","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingDetail"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The filing was deleted."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"One filing with entities, documents, events and its version chain. A deleted filing returns 410. accepted_at and period_of_report are SEC's snapshot values when the snapshot lists the filing.","tags":["filings"]}},"/v3/filings/{accession}/documents":{"get":{"operationId":"get_filings__accession__documents","parameters":[{"description":"Accession number, with dashes (0001829126-26-010431) or without (18 digits).","in":"path","name":"accession","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The filing was deleted."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Documents of a filing, in sequence order.","tags":["filings"]}},"/v3/filings/{accession}/documents/{document}":{"get":{"operationId":"get_filings__accession__documents__document_","parameters":[{"description":"Accession number, with dashes (0001829126-26-010431) or without (18 digits).","in":"path","name":"accession","required":true,"schema":{"type":"string"}},{"description":"Sequence number (1, 2, ...) or the document's filename.","in":"path","name":"document","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"format":"binary","type":"string"}}},"description":"The stored bytes.","headers":{"Accept-Ranges":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}}},"206":{"content":{"*/*":{"schema":{"format":"binary","type":"string"}}},"description":"The requested byte range."},"304":{"description":"Not modified (If-None-Match matched the ETag)."},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The filing was deleted."},"416":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Range not satisfiable."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Stored bytes of one document. Supports ETag / If-None-Match (304) and single-range Range requests (206). Served with Content-Security-Policy: sandbox.","tags":["filings"]}},"/v3/filings/{accession}/events":{"get":{"operationId":"get_filings__accession__events","parameters":[{"description":"Accession number, with dashes (0001829126-26-010431) or without (18 digits).","in":"path","name":"accession","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventList"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The filing was deleted."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Lifecycle events of a filing, oldest first.","tags":["filings"]}},"/v3/filings/{accession}/header":{"get":{"operationId":"get_filings__accession__header","parameters":[{"description":"Accession number, with dashes (0001829126-26-010431) or without (18 digits).","in":"path","name":"accession","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"*/*":{"schema":{"format":"binary","type":"string"}}},"description":"The stored bytes.","headers":{"Accept-Ranges":{"schema":{"type":"string"}},"ETag":{"schema":{"type":"string"}}}},"206":{"content":{"*/*":{"schema":{"format":"binary","type":"string"}}},"description":"The requested byte range."},"304":{"description":"Not modified (If-None-Match matched the ETag)."},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The filing was deleted."},"416":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Range not satisfiable."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"The stored SGML header (_header.sgml) as text/plain.","tags":["filings"]}},"/v3/filings/{accession}/versions":{"get":{"operationId":"get_filings__accession__versions","parameters":[{"description":"Accession number, with dashes (0001829126-26-010431) or without (18 digits).","in":"path","name":"accession","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Versions"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"404":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Not found."},"410":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"The filing was deleted."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Version chain of the filing's report: the original and every amendment, with how each amendment was linked. Members are ordered by amendment_seq, which the linker assigns; that order can still change until the snapshot lists every member.","tags":["filings"]}},"/v3/forms":{"get":{"operationId":"get_forms","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormList"}}},"description":"OK"},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Form types present (deleted filings excluded) with filing counts, most frequent first. Recomputed at most once a minute.","tags":["meta"]}},"/v3/health":{"get":{"operationId":"get_health","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}},"description":"OK"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}},"description":"The database is down."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[],"summary":"Liveness: one database round trip, the document root, and whether the snapshot store is usable. 200 unless the database is down.","tags":["meta"]}},"/v3/openapi.json":{"get":{"operationId":"get_openapi_json","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApi"}}},"description":"OK"},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[],"summary":"This OpenAPI 3.1 document.","tags":["meta"]}},"/v3/reports":{"get":{"operationId":"get_reports","parameters":[{"description":"Primary CIK of the report, padded or unpadded. Required.","in":"query","name":"cik","required":false,"schema":{"type":"string"}},{"description":"Base form(s) of the chain's first filing, exact, e.g. 10-K or 10-K,10-Q.","explode":false,"in":"query","name":"form","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Only chains whose first filing has this period_of_report.","in":"query","name":"period","required":false,"schema":{"format":"date","type":"string"}},{"description":"Page size, 1..200.","in":"query","name":"limit","required":false,"schema":{"default":50,"type":"integer"}},{"description":"Opaque cursor from a previous page's next_cursor. Must be used with the same filters.","in":"query","name":"cursor","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportList"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Reports of one entity: one row per version chain (an original plus its amendments), ordered by the original filing's date, newest first (a chain whose original is not ingested is dated by its first ingested amendment). form and period filter on that first filing (period on its header value); only filings numbered by the linker are listed. period_of_report and latest.accepted_at carry SEC's snapshot values when available (snapshot block).","tags":["filings"]}},"/v3/resolve":{"get":{"operationId":"get_resolve","parameters":[{"description":"Ticker symbol (case-insensitive): 1 to 16 letters, digits, '.' or '-'. Required.","in":"query","name":"ticker","required":false,"schema":{"type":"string"}},{"description":"Date to resolve on, YYYY-MM-DD. Default: the newest copy.","in":"query","name":"as_of","required":false,"schema":{"format":"date","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveResult"}}},"description":"OK"},"400":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Invalid or unknown parameter."},"401":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Missing, invalid or inactive API key."},"503":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Database unavailable; retry after the Retry-After delay."},"default":{"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}},"description":"Any other error (405, 500, 504)."}},"security":[{"bearer":[]},{"api_key_header":[]},{"api_key_query":[]}],"summary":"Which CIK(s) hold a ticker, from SEC's ticker file; with as_of, from the copy that was current on that date. Empty data when the ticker is unknown, the date precedes coverage_from, or the snapshot store is unavailable.","tags":["entities"]}}},"servers":[{"url":"/"}]}