# FERC eForms XBRL Submission API

**Canonical:** https://apis.io/apis/ferc/ferc-eforms-xbrl-submission-api/  
**Provider:** FERC — https://apis.io/providers/ferc/  
**Base URL:** https://ecollection.ferc.gov/api  
**Documentation:** https://www.ferc.gov/vendor-files-library

FERC eForms XBRL Submission API is one of 2 APIs that [FERC](https://apis.io/providers/ferc/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include XBRL, Regulatory Filing, eForms, and Compliance. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

The machine-to-machine API behind FERC's mandated eForms. Credentialed filers exchange their FERC eRegistration and Company Registration username and password for a bearer token at POST /api/token (OAuth2 password grant, role=filer), then POST a zipped XBRL submission to /api/SubmissionHistory/ExternalFiling with the company CID, report year, report period, and form identifier. FERC documents only that write path, but the API is not write-only — a second-round probe on 2026-07-27 found an undocumented ANONYMOUS read surface on the same host — GET /api/PublicSubmissionHistory (37,588 filing records, 10.6 MB, no key), /api/SubmissionDetail/{filingID} (accession number and attachment manifest), /api/SubmissionHistory/forms, /api/getTestStatus, /api/faq, and the full XBRL taxonomy release history at /api/TaxonomyHistory with its taxonomy packages, sample forms and release notes. Those endpoints are described in a DERIVED OpenAPI in this repo (FERC publishes none), built from FERC's own production JavaScript bundle plus its published Postman collection, with every path probed live. Verified 2026-07-27 — POST /api/token without valid credentials returns HTTP 400 with "Failed validating user in company registration", and the credentialed endpoints (/api/claims, /api/SubmissionHistory, /api/TaxonomyRevision) return HTTP 401.

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ferc/refs/heads/main/openapi/ferc-eforms-api-openapi-derived.yml
- **PostmanCollection** — https://raw.githubusercontent.com/api-evangelist/ferc/refs/heads/main/collections/ferc-xbrl-submission-api.postman_collection.json
- **Documentation** — https://www.ferc.gov/media/ferc-submission-api-step-step-guide
- **GettingStarted** — https://www.ferc.gov/sites/default/files/2020-12/FERC_SubmissionAPI_PROD-Step-by-step-guide_v3.1.pdf
- **Portal** — https://ecollection.ferc.gov/
- **Registration** — https://www.ferc.gov/company-registration
- **Documentation** — https://www.ferc.gov/filing-forms/eforms-refresh

## Other FERC APIs (1)

- [FERC Open Data API](https://apis.io/apis/ferc/ferc-open-data-api/)

## Tags

XBRL, Regulatory Filing, eForms, Compliance

---

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