Retrieve SEC EDGAR XBRL company facts (financials, filings) via pay-per-call MPP endpoint.
What it does
This endpoint provides access to SEC EDGAR Company Facts data through the Locus MPP (Micropayment Protocol) gateway. By supplying a company's CIK number, you receive the full set of XBRL financial facts reported by that company to the SEC — covering income statements, balance sheets, cash flows, and other structured disclosures.
The endpoint is part of a broader EDGAR service that also includes Company Submissions (filing history) and Company Concept (single XBRL tag lookups) at sibling paths. Each call is settled via Tempo L2 using pathUSD at a cost of 8,000 base units (approximately $0.008 per request, assuming pathUSD uses 6 decimals). The endpoint accepts POST requests with a JSON body containing a single required field: the SEC CIK number for the target company.
The OpenAPI spec references SEC's own developer documentation at sec.gov/developer and an LLM-oriented doc at beta.paywithlocus.com/mpp/edgar.md. Note that the probe did not receive a 402 challenge on HEAD/GET — the endpoint is POST-only, which is consistent with the OpenAPI schema. No response schema is documented, so the exact shape of the returned data must be inferred from SEC EDGAR's public API structure (typically a JSON object with taxonomy-keyed facts and filing metadata).
Capabilities
Use cases
- —Retrieve all XBRL-reported financial facts for a public company by CIK number
- —Build automated financial analysis pipelines that pull structured SEC data
- —Power AI agents that need on-demand access to SEC financial disclosures
- —Compare historical financial metrics across filing periods for a given company
Fit
Best for
- —AI agents needing structured SEC financial data without managing API keys
- —Pay-per-call access to EDGAR data without rate-limit concerns of the free SEC API
- —Automated workflows that query company-level XBRL facts programmatically
Not for
- —Bulk downloading the entire EDGAR dataset (this is per-company, per-call)
- —Searching across filings by keyword (see the sibling full-text search endpoint instead)
- —Free-tier usage — every call requires a micropayment
Quick start
curl -X POST https://edgar.mpp.paywithlocus.com/edgar/company-facts \
-H "Content-Type: application/json" \
-d '{"cik": "320193"}'Example
Request
{
"cik": "320193"
}Endpoint
Quality
The OpenAPI spec provides clear request schemas, pricing, and endpoint structure for three sibling paths. However, no response schema is documented, the probe did not capture a 402 challenge (endpoint is POST-only so HEAD/GET returned 404, which is expected), and crawled pages returned only generic 'not found' messages. Price decimals for pathUSD are inferred (6 decimals) but not confirmed in the bundle.
Warnings
- —No response schema documented — the shape of successful responses is unknown from provided material.
- —Probe returned 404 on HEAD/GET; endpoint is POST-only per OpenAPI spec, so liveness could not be confirmed via the probe.
- —pathUSD decimals assumed to be 6 (standard for USD stablecoins); price of ~$0.008 per call is inferred, not confirmed.
- —No crawled documentation was retrievable — all auxiliary pages returned 'not found'.
Citations
- —The endpoint accepts POST with a required 'cik' field and is priced at 8000 base units of pathUSD via Tempo settlement.https://edgar.mpp.paywithlocus.com
- —The broader EDGAR service includes Company Submissions, Company Facts, and Company Concept endpoints.https://edgar.mpp.paywithlocus.com
- —SEC EDGAR developer documentation is referenced as the upstream data source.https://www.sec.gov/developer
- —LLM-oriented documentation is available at beta.paywithlocus.com/mpp/edgar.md.https://beta.paywithlocus.com/mpp/edgar.md