{"openapi":"3.1.0","info":{"title":"SEC EDGAR (data.sec.gov) Public Data APIs","description":"Official EDGAR data APIs hosted at data.sec.gov. These endpoints provide public, real-time JSON access to company submissions and aggregated XBRL facts (Company Facts, Company Concept, and Frames). No API key or authentication is required.\n\nAccess & usage requirements:\n- Base host: https://data.sec.gov (production).\n- User-Agent header: You must declare a descriptive User-Agent that includes contact information for your script or app (e.g., \"ExampleCo API Client admin@example.com\"). Requests without a clear User-Agent may be throttled or blocked with an “Undeclared Automated Tool” error. Accept-Encoding: gzip, deflate is supported. See SEC Webmaster FAQs for details.\n- Rate limits: Maximum 10 requests per second across sec.gov/data.sec.gov resources to preserve equitable access. Exceeding this can result in 429 errors or temporary blocking.\n- CORS: Cross Origin Resource Sharing (CORS) is not supported on data.sec.gov; do not call these APIs directly from browsers without a same-origin proxy.\n- Update cadence: Submissions are updated in near real time (typical delay < 1s), XBRL facts (Company Facts/Concept/Frames) in near real time (typical delay < 1 minute). During peak filing times delays may be longer. Bulk ZIP archives are recompiled nightly at approximately 3:00 a.m. ET.\n- Pagination: The Submissions JSON includes a compact \"filings.recent\" array and, when applicable, a \"filings.files\" array listing additional JSON ranges for older filings (follow those URLs to page back in time).\n- Bulk access: For large-scale ingestion, prefer the nightly companyfacts.zip (covers Company Facts and Frames) and submissions.zip (all filers’ submission histories) rather than many small API calls.\n\nPolicies & references: See EDGAR Application Programming Interfaces page for endpoint formats, frames period rules, and bulk archive locations; and the Webmaster Frequently Asked Questions (Developers) for programmatic access, maximum access rate (10 rps), User-Agent declaration, and related guidance.\n\nNOTE: servers.url below is the live API host — using the example x-onestop-sample URLs in each operation should return HTTP 200 when the resource exists.","version":"2026-06-11"},"servers":[{"url":"https://api.onestop.sh/v1/invoke/one-stop/us-public-company-filings-sec-edgar"}],"security":[{"oneStopApiKey":[]}],"components":{"securitySchemes":{"oneStopApiKey":{"type":"http","scheme":"bearer"}}},"paths":{"/submissions/CIK{cik}.json":{"get":{"operationId":"getSubmissionsByCik","summary":"Get an entity's EDGAR submission history by CIK","description":"Returns the current filing history JSON for the specified entity CIK. The CIK must be 10 digits including leading zeros (example: 0000320193 for Apple Inc.). The response contains entity metadata (current/former names, tickers, exchanges) and a compact, columnar array of recent filings. If the entity has more than one year or more than 1,000 recent filings, a \"filings.files\" array lists additional JSON files with date ranges, which you can follow to retrieve older filings (server-side pagination). Data is updated in near real time as EDGAR disseminates submissions.\n\nUsage notes:\n- Declare a descriptive User-Agent header with contact info.\n- Respect a maximum of 10 requests per second.\n- For bulk use, prefer the nightly submissions.zip archive.","parameters":[{"name":"cik","in":"path","description":"10-digit CIK for the entity (include leading zeros). Example: 0000320193 (Apple Inc.).","required":true,"style":"simple","explode":false,"schema":{"type":"string","pattern":"^[0-9]{10}$","description":"10-digit Central Index Key (CIK) with leading zeros.","example":"0000320193"}},{"name":"User-Agent","in":"header","description":"Required by SEC for scripted access. Include org/app name and a contact email.","required":true,"style":"simple","explode":false,"schema":{"type":"string","description":"Identify your application and include contact info. Requests without a clear User-Agent may be blocked.","example":"ExampleCo EDGAR Client (admin@example.com)"}},{"name":"Accept-Encoding","in":"header","description":"Optional but recommended to reduce payload size.","required":false,"style":"simple","explode":false,"schema":{"type":"string","description":"Compression encodings supported by the client.","example":"gzip, deflate"}}],"responses":{"200":{"description":"Response."},"400":{"description":"Response."},"403":{"description":"Response."},"404":{"description":"Response."},"429":{"description":"Response."}}}},"/api/xbrl/companyfacts/CIK{cik}.json":{"get":{"operationId":"getCompanyFactsByCik","summary":"Get aggregated XBRL Company Facts for a company","description":"Returns aggregated XBRL 'companyfacts' JSON for the specified company CIK. Includes every disclosed concept, grouped by taxonomy and unit of measure, with arrays of facts containing values, dates, filing metadata, and flags. The CIK must be 10 digits (include leading zeros).","parameters":[{"name":"cik","in":"path","description":"10-digit company CIK (include leading zeros). Example: 0000320193.","required":true,"style":"simple","explode":false,"schema":{"type":"string","pattern":"^[0-9]{10}$","example":"0000320193"}},{"name":"User-Agent","in":"header","description":"Required by SEC for scripted access. Include org/app name and a contact email.","required":true,"style":"simple","explode":false,"schema":{"type":"string","description":"Identify your application and include contact info. Requests without a clear User-Agent may be blocked.","example":"ExampleCo EDGAR Client (admin@example.com)"}},{"name":"Accept-Encoding","in":"header","description":"Optional but recommended to reduce payload size.","required":false,"style":"simple","explode":false,"schema":{"type":"string","description":"Compression encodings supported by the client.","example":"gzip, deflate"}}],"responses":{"200":{"description":"Response."},"400":{"description":"Response."},"403":{"description":"Response."},"404":{"description":"Response."},"429":{"description":"Response."}}}},"/api/xbrl/companyconcept/CIK{cik}/{taxonomy}/{concept}.json":{"get":{"operationId":"getCompanyConceptByCikTaxonomyConcept","summary":"Get XBRL disclosures for a single company and concept","description":"Returns all XBRL disclosures for the specified company (CIK), taxonomy (e.g., us-gaap, ifrs-full, dei, srt), and concept tag (case-sensitive, e.g., AccountsPayableCurrent). The response groups facts by unit of measure and includes reporting context (dates), fiscal period/year, and filing metadata.","parameters":[{"name":"cik","in":"path","description":"10-digit CIK (include leading zeros). Example: 0000320193.","required":true,"style":"simple","explode":false,"schema":{"type":"string","pattern":"^[0-9]{10}$","example":"0000320193"}},{"name":"taxonomy","in":"path","description":"XBRL taxonomy (e.g., us-gaap, ifrs-full, dei, srt).","required":true,"style":"simple","explode":false,"schema":{"type":"string","example":"us-gaap"}},{"name":"concept","in":"path","description":"XBRL concept tag name (case-sensitive).","required":true,"style":"simple","explode":false,"schema":{"type":"string","example":"AccountsPayableCurrent"}},{"name":"User-Agent","in":"header","description":"Required by SEC for scripted access. Include org/app name and a contact email.","required":true,"style":"simple","explode":false,"schema":{"type":"string","description":"Identify your application and include contact info. Requests without a clear User-Agent may be blocked.","example":"ExampleCo EDGAR Client (admin@example.com)"}},{"name":"Accept-Encoding","in":"header","description":"Optional but recommended to reduce payload size.","required":false,"style":"simple","explode":false,"schema":{"type":"string","description":"Compression encodings supported by the client.","example":"gzip, deflate"}}],"responses":{"200":{"description":"Response."},"400":{"description":"Response."},"403":{"description":"Response."},"404":{"description":"Response."},"429":{"description":"Response."}}}},"/api/xbrl/frames/{taxonomy}/{concept}/{unit}/{period}.json":{"get":{"operationId":"getXbrlFrame","summary":"Get a frame-level aggregated XBRL fact","description":"Returns one fact per reporting entity most closely aligned to the requested calendrical period. Period format: CY#### (annual), CY####Q# (quarterly), CY####Q#I (instantaneous). Unit must match XBRL unit strings (e.g., USD, USD-per-share, shares, pure). Where the unit has numerator and denominator they are separated by “-per-”. Example: /api/xbrl/frames/us-gaap/AccountsPayableCurrent/USD/CY2019Q1I.json.\n\nNotes:\n- Because fiscal calendars vary (start/end dates, week alignment), the API assembles frames to best align with the calendar quarter or year ± a tolerance (annual ~365±30 days; quarterly ~91±30 days).","parameters":[{"name":"taxonomy","in":"path","description":"Taxonomy namespace, e.g., us-gaap, ifrs-full.","required":true,"style":"simple","explode":false,"schema":{"type":"string","example":"us-gaap"}},{"name":"concept","in":"path","description":"XBRL concept tag (case-sensitive).","required":true,"style":"simple","explode":false,"schema":{"type":"string","example":"AccountsPayableCurrent"}},{"name":"unit","in":"path","description":"Unit of measure (e.g., USD, USD-per-share, shares, pure). For ratios use the “-per-” convention.","required":true,"style":"simple","explode":false,"schema":{"type":"string","example":"USD"}},{"name":"period","in":"path","description":"Period identifier: CY#### (annual), CY####Q# (quarterly), or CY####Q#I (instantaneous).","required":true,"style":"simple","explode":false,"schema":{"type":"string","pattern":"^CY[0-9]{4}(Q[1-4](I)?)?$","example":"CY2023Q1I"}},{"name":"User-Agent","in":"header","description":"Required by SEC for scripted access. Include org/app name and a contact email.","required":true,"style":"simple","explode":false,"schema":{"type":"string","description":"Identify your application and include contact info. Requests without a clear User-Agent may be blocked.","example":"ExampleCo EDGAR Client (admin@example.com)"}},{"name":"Accept-Encoding","in":"header","description":"Optional but recommended to reduce payload size.","required":false,"style":"simple","explode":false,"schema":{"type":"string","description":"Compression encodings supported by the client.","example":"gzip, deflate"}}],"responses":{"200":{"description":"Response."},"400":{"description":"Response."},"403":{"description":"Response."},"404":{"description":"Response."},"429":{"description":"Response."}}}},"/Archives/edgar/daily-index/xbrl/companyfacts.zip":{"get":{"operationId":"getBulkCompanyFactsZip","summary":"Download nightly compiled companyfacts.zip (bulk archive)","description":"Bulk ZIP archive containing all data from the XBRL Company Facts and XBRL Frames APIs. Republished nightly at approximately 3:00 a.m. ET. Use for large-scale ingestion instead of many individual API calls.","parameters":[{"name":"User-Agent","in":"header","description":"Required by SEC for scripted access. Include org/app name and a contact email.","required":true,"style":"simple","explode":false,"schema":{"type":"string","description":"Identify your application and include contact info. Requests without a clear User-Agent may be blocked.","example":"ExampleCo EDGAR Client (admin@example.com)"}},{"name":"Accept-Encoding","in":"header","description":"Optional.","required":false,"style":"simple","explode":false,"schema":{"type":"string","description":"Compression encodings supported by the client. Note: ZIP responses are already compressed.","example":"gzip, deflate"}}],"responses":{"200":{"description":"Response."},"403":{"description":"Response."},"404":{"description":"Response."},"429":{"description":"Response."}}}},"/Archives/edgar/daily-index/bulkdata/submissions.zip":{"get":{"operationId":"getBulkSubmissionsZip","summary":"Download nightly compiled submissions.zip (bulk archive)","description":"Bulk ZIP archive containing the public EDGAR filing history for all filers as exposed by the Submissions API. Updated and republished nightly at approximately 3:00 a.m. ET.","parameters":[{"name":"User-Agent","in":"header","description":"Required by SEC for scripted access. Include org/app name and a contact email.","required":true,"style":"simple","explode":false,"schema":{"type":"string","description":"Identify your application and include contact info. Requests without a clear User-Agent may be blocked.","example":"ExampleCo EDGAR Client (admin@example.com)"}},{"name":"Accept-Encoding","in":"header","description":"Optional.","required":false,"style":"simple","explode":false,"schema":{"type":"string","description":"Compression encodings supported by the client. Note: ZIP responses are already compressed.","example":"gzip, deflate"}}],"responses":{"200":{"description":"Response."},"403":{"description":"Response."},"404":{"description":"Response."},"429":{"description":"Response."}}}}}}