# SEC EDGAR Submission Status API API

**Canonical:** https://apis.io/apis/sec/sec-submission-status-api-api/  
**Provider:** SEC EDGAR — https://apis.io/providers/sec/  
**Base URL:** https://data.sec.gov  
**Documentation:** https://www.sec.gov/edgar/sec-api-documentation

SEC EDGAR Submission Status API API is one of 9 APIs that [SEC EDGAR](https://apis.io/providers/sec/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Submission Status API. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

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, 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 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. 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, regardless of type, are retained for six (6) days.

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/sec/refs/heads/main/openapi/sec-submission-status-api-api-openapi.yml
- **Documentation** — https://www.sec.gov/edgar/sec-api-documentation
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sec/refs/heads/main/json-schema/sec-company-submissions.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/sec/refs/heads/main/json-schema/sec-xbrl-fact-value.json
- **Documentation** — https://www.sec.gov/submit-filings/filer-support-resources/how-do-i-guides/understand-edgar-application-programming-interfaces-apis

## Other SEC EDGAR APIs (8)

- [SEC EDGAR Company Concept API](https://apis.io/apis/sec/sec-company-concept-api/)
- [SEC EDGAR Company Facts API](https://apis.io/apis/sec/sec-company-facts-api/)
- [SEC EDGAR EDGAR Operational Status API API](https://apis.io/apis/sec/sec-edgar-operational-status-api-api/)
- [SEC EDGAR Filer Management API API](https://apis.io/apis/sec/sec-filer-management-api-api/)
- [SEC EDGAR Frames API](https://apis.io/apis/sec/sec-frames-api/)
- [SEC EDGAR Search API](https://apis.io/apis/sec/sec-search-api/)
- [SEC EDGAR Submission API API](https://apis.io/apis/sec/sec-submission-api-api/)
- [SEC EDGAR Submissions API](https://apis.io/apis/sec/sec-submissions-api/)

## Tags

Submission Status API

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/sec/sec-submission-status-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/sec/.