SEC EDGAR website screenshot

SEC EDGAR

The U.S. Securities and Exchange Commission (SEC) EDGAR (Electronic Data Gathering, Analysis, and Retrieval) system provides free public access to corporate financial filings submitted to the SEC. The EDGAR REST API at data.sec.gov delivers JSON-formatted data without requiring authentication or API keys, covering company submissions, XBRL financial facts, and company concept data. Endpoints support CIK lookups, full filing history, structured XBRL financial disclosures across reporting periods, and cross-company comparative frames for US-GAAP and IFRS taxonomies.

SEC EDGAR publishes 9 APIs on the APIs.io network, including Company Concept API, Company Facts API, EDGAR Operational Status API API, and 6 more. Tagged areas include Financial Data, SEC, EDGAR, Public Company Filings, and XBRL.

The SEC EDGAR catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

SEC EDGAR’s developer surface includes authentication, documentation, engineering blog, pricing, and 13 more developer resources.

49.8/100 developing ▬ flat Agent 48/100 agent ready Full breakdown ↓
scored 2026-07-27 · rubric v0.5
AccessFreeSelf serve⚡ Free to try
9 APIs
Financial DataSECEDGARPublic Company FilingsXBRLRegulatoryGovernmentFinancial ReportingCompany SubmissionsSecurities

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 49.8/100 · developing
Contract Quality 18.7 / 25
Developer Ergonomics 4.3 / 20
Commercial Clarity 7.9 / 20
Operational Transparency 0.7 / 13
Governance 10.4 / 12
Discoverability 10.0 / 10
Agent readiness — 48/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 15 / 15
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/sec: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 9

Individual APIs this provider publishes, each with its own machine-readable definition.

SEC EDGAR Company Concept API

Historical values for a single XBRL concept

SEC EDGAR Company Facts API

XBRL financial disclosures for a company

SEC EDGAR EDGAR Operational Status API API

This API reports the status of the EDGAR system. This resource requires presentation of a Filer API Token only.

SEC EDGAR Filer Management API API

A set of API endpoints that allows you to verify permissions, get filer information, manage CCC, manage individuals, and manage delegations.

SEC EDGAR Frames API

Cross-company data for a concept in a specific period

SEC EDGAR Search API

Full-text search across EDGAR filing documents

SEC EDGAR Submission API API

Submission of filings to EDGAR by API can be made through the Submission API. The Submission API requires the presentation of a Filer API Token in combination with a User API To...

SEC EDGAR Submission Status API API

The Submission Status API provides information from the EDGAR system. It requires a Filer API Token and accession number(s). To obtain information about a submission through the...

SEC EDGAR Submissions API

Company filing history and metadata by CIK

Scroll for all 9

Pricing Plans 1

Published pricing tiers and plan structures.

Sec Plans Pricing

1 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Sec Rate Limits

0 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Sec Finops

FINOPS

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Sec Context

5 classes · 40 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

SEC EDGAR API Rules

5 rules · 3 warnings 2 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

SEC EDGAR Company Submissions

24 properties

JSON SCHEMA

SEC EDGAR XBRL Fact Value

9 properties

JSON SCHEMA

Examples 3

Example request and response payloads for these APIs.

Sec Xbrl Frames Example

8 fields

EXAMPLE

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Sec Authentication

http · 1 scheme

SECURITY

Sec Domain Security

TLSv1.3 · DNSSEC · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Sec Agentic Access

23 operations · 12 acting

23 operations · 12 acting

AGENTIC

Resources

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 2

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 4

The organization behind the API

Other 2

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: https://raw.githubusercontent.com/api-evangelist/sec/refs/heads/main/apis.yml
name: SEC EDGAR
description: 'The U.S. Securities and Exchange Commission (SEC) EDGAR (Electronic Data Gathering, Analysis, and Retrieval)
  system provides free public access to corporate financial filings submitted to the SEC. The EDGAR REST API at data.sec.gov
  delivers JSON-formatted data without requiring authentication or API keys, covering company submissions, XBRL financial
  facts, and company concept data. Endpoints support CIK lookups, full filing history, structured XBRL financial disclosures
  across reporting periods, and cross-company comparative frames for US-GAAP and IFRS taxonomies.

  '
type: Index
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/sec.png
url: https://raw.githubusercontent.com/api-evangelist/sec/refs/heads/main/apis.yml
created: '2026-06-12'
modified: '2026-06-12'
specificationVersion: '0.19'
tags:
- Financial Data
- SEC
- EDGAR
- Public Company Filings
- XBRL
- Regulatory
- Government
- Financial Reporting
- Company Submissions
- Securities
apis:
- aid: sec:sec-company-concept-api
  name: SEC EDGAR Company Concept API
  description: Historical values for a single XBRL concept
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Company Concept
  properties:
  - type: OpenAPI
    url: openapi/sec-company-concept-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-company-facts-api
  name: SEC EDGAR Company Facts API
  description: XBRL financial disclosures for a company
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Company Facts
  properties:
  - type: OpenAPI
    url: openapi/sec-company-facts-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-edgar-operational-status-api-api
  name: SEC EDGAR EDGAR Operational Status API API
  description: This API reports the status of the EDGAR system. This resource requires presentation of a Filer API Token only.
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - EDGAR Operational Status API
  properties:
  - type: OpenAPI
    url: openapi/sec-edgar-operational-status-api-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-filer-management-api-api
  name: SEC EDGAR Filer Management API API
  description: A set of API endpoints that allows you to verify permissions, get filer information, manage CCC, manage individuals,
    and manage delegations.
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Filer Management API
  properties:
  - type: OpenAPI
    url: openapi/sec-filer-management-api-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-frames-api
  name: SEC EDGAR Frames API
  description: Cross-company data for a concept in a specific period
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Frames
  properties:
  - type: OpenAPI
    url: openapi/sec-frames-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-search-api
  name: SEC EDGAR Search API
  description: Full-text search across EDGAR filing documents
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/sec-search-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-submission-api-api
  name: SEC EDGAR Submission API API
  description: "Submission of filings to EDGAR by API can be made through the Submission API. The Submission API requires\
    \ the presentation of a Filer API Token in combination with a User API Token. Optionally,\n    filers could also specify\
    \ a login CIK if there is a delegation from the EDGAR account corresponding\nto the login CIK to the filer API token EDGAR\
    \ account/CIK. Delegations can be established on\n    the Filer Management dashboard under “Manage Delegations and User\
    \ Groups.” For more information\non establishing delegations,\n    see [How Do I “Understand and Manage Delegation.](https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-manage-delegation)”\n\
    \n    Filings transmitted through the Submission API are expected to conform to the filing standard(s)\n[provided by the\
    \ SEC](https://www.sec.gov/submit-filings).\n    Information is provided on the required format and contents of filings\
    \ by the [Technical Specifications](https://www.sec.gov/submit-filings/technical-specifications).\n    Information and\
    \ guidance on filing can be found in the [EDGAR Filing Manual](https://www.sec.gov/submit-filings/edgar-filer-manual).\n\
    \    Information on specific forms can be found in the [SEC Forms Index](https://www.sec.gov/submit-filings/forms-index).\n\
    \n    The Submission API will return accession numbers for the submitted filings. A 202 HTTP status\ncode indicates only\
    \ that processing will begin in EDGAR and an\n    accession number or accession numbers have been generated. Filings with\
    \ errors will be processed\nand suspended by EDGAR. The results of processing (status and errors)\n    are not provided\
    \ by this endpoint and are instead available to clients using the API through the\nSubmission Status API.\n\n    When\
    \ using Submission API endpoints, the client can optionally specify the \"Expect: 100-continue\"\nHTTP request header\
    \ to allow a response from these API resources\n    to be returned before uploading the entire filing in the event that\
    \ the EDGAR API determines that\nthe request will not be allowed.\n    This header should only be used for requests that\
    \ have a body more than 1MiB in size.\n\n    Filings may be transmitted via either SINGLE or BULK transmission. A SINGLE\
    \ transmission provides\na single filling and will result in a response containing an accession number if the filing is\
    \ transmitted successfully or an error if there is an issue while transmitting the filing. Even if a filing is successfully\
    \ transmitted through the submission API, the filing may still be suspended by EDGAR if the contents of the filing do\
    \ not satisfy EDGAR filing requirements. The accession number may be provided to the Submission Status API in order to\
    \ check whether the filing was accepted by EDGAR.\n\n    A BULK filing, in contrast, is a single document that contains\
    \ multiple filings to be submitted.\nIf one or more filings are successfully transmitted then one or more accession numbers\
    \ will be created and returned in the same order filings are included in the BULK filing document. However, if a filing\
    \ is not successfully transmitted then an accession number may not be created, which means that the filer may have difficulty\
    \ determining which accession number corresponds to which filing in the BULK filing document. Even if a filing is successfully\
    \ transmitted through the Submission API, the filing may still be suspended by EDGAR if the contents of the filing do\
    \ not satisfy EDGAR filing requirements. The relevant accession number may be provided to the Submission Status API in\
    \ order to check whether the filing was accepted by EDGAR."
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Submission API
  properties:
  - type: OpenAPI
    url: openapi/sec-submission-api-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-submission-status-api-api
  name: SEC EDGAR Submission Status API API
  description: "The Submission Status API provides information from the EDGAR system. It requires a Filer API Token and accession\
    \ number(s). To obtain information about a submission through the Submission Status API,\n    you must use a Filer API\
    \ Token that belongs to the CIK that submitted the filing or the CIK that was the filer for the submission. The Submission\
    \ Status API will only return the detailed information about\n    the filling (like error codes or the filer notification\
    \ text) once the filing has reached the end of processing signified by the field 'final' being set to true.\n    \n\n\
    \    The statuses of filings are retained for limited amounts of time. The statuses of Accepted TEST filings are retained\
    \ for two (2) days,  Accepted LIVE filings are retained for sixty (60) days, and Suspended filings,\n    regardless of\
    \ type, are retained for six (6) days."
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Submission Status API
  properties:
  - type: OpenAPI
    url: openapi/sec-submission-status-api-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
- aid: sec:sec-submissions-api
  name: SEC EDGAR Submissions API
  description: Company filing history and metadata by CIK
  humanURL: https://www.sec.gov/edgar/sec-api-documentation
  baseURL: https://data.sec.gov
  tags:
  - Submissions
  properties:
  - type: OpenAPI
    url: openapi/sec-submissions-api-openapi.yml
  - type: Documentation
    url: https://www.sec.gov/edgar/sec-api-documentation
  - type: JSONSchema
    url: json-schema/sec-company-submissions.json
  - type: JSONSchema
    url: json-schema/sec-xbrl-fact-value.json
  - type: Documentation
    url: https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis
common:
- type: AgenticAccess
  url: agentic-access/sec-agentic-access.yml
- type: DomainSecurity
  url: security/sec-domain-security.yml
- type: Authentication
  url: authentication/sec-authentication.yml
- type: Website
  url: https://www.sec.gov
- type: Documentation
  url: https://www.sec.gov/edgar/sec-api-documentation
- type: Developer
  url: https://www.sec.gov/about/developer-resources
- type: GitHubOrg
  url: https://github.com/sec-gov
- type: LinkedIn
  url: https://www.linkedin.com/company/us-securities-and-exchange-commission
- type: Blog
  url: https://www.sec.gov/newsroom
- type: Pricing
  url: https://www.sec.gov/edgar/sec-api-documentation
- type: X
  url: https://x.com/SEC_News
- type: Plans
  url: plans/sec-plans-pricing.yml
- type: RateLimits
  url: rate-limits/sec-rate-limits.yml
- type: FinOps
  url: finops/sec-finops.yml
- type: Vocabulary
  url: vocabulary/sec-vocabulary.yml
- type: JSONLDContext
  url: json-ld/sec-context.jsonld
- type: Blog
  url: blogs/blogs.json
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com