# SEC EDGAR Company Concept

> SEC EDGAR Company Concept is a paid API for AI agents from EDGAR (SEC) at edgar.mpp.paywithlocus.com, paid per call via MPP, $0.008/call, status unknown (last checked 2026-10-10).

Retrieves all reported values for a specific XBRL financial concept (e.g. Assets, Revenues) for a given SEC-registered company across all filing periods.

## Facts

- Endpoint: POST https://edgar.mpp.paywithlocus.com/edgar/company-concept?utm_source=zero.xyz
- Price: $0.008/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: EDGAR (SEC)
- Docs: https://www.sec.gov/developer
- Website: https://www.sec.gov/developer
- Tags: sec, filings, company-data, financials, data
- Canonical page: https://www.zero.xyz/c/edgar-sec-company-concept-a5b0e423
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EKzcmjoFZLy8a0bmzC3g0

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability edgar-sec-company-concept-a5b0e423 -d '<json body>'
```

Example prompt: Pull all the historical 'Revenues' figures that Apple (CIK 320193) has reported to the SEC using the us-gaap taxonomy — I want to see every period they've filed that concept.

## When to prefer this

Use this endpoint when you need a time-series of a single specific financial concept (e.g. Assets, Revenues, NetIncomeLoss) for one company across all reporting periods. Prefer this over Company Facts when you only need one concept rather than the full set of all XBRL facts, making response payloads smaller and queries more targeted. Best for financial analysis, charting historical trends, or building datasets around a particular accounting line item.

## Known failure modes

- Invalid or unknown CIK returns 404 not found
- Unrecognized taxonomy value (not us-gaap, ifrs-full, dei, or srt) causes a bad request error
- XBRL tag not found for the specified company/taxonomy combination returns empty or 404
- Company has never filed the requested concept tag — returns no data
- Malformed CIK format (e.g. non-numeric string) causes validation error
- Network timeout or upstream EDGAR API unavailability returns 503

## How this service works

Time series for a single XBRL financial concept — retrieve every reported value for a specific metric (e.g. Assets, Revenues, NetIncomeLoss) across all filings. Smaller and faster than company-facts for targeted queries.

## Output

Returns all reported values for the specified XBRL concept tag across every filing period for the given company, including the taxonomy, label, description, unit of measure, and time-series data points (start/end dates, form type, filed date, and value for each period).

## Example request

```json
{
 "cik": "320193",
 "tag": "Revenues",
 "taxonomy": "us-gaap"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "cik",
  "taxonomy",
  "tag"
 ],
 "properties": {
  "cik": {
   "type": "string",
   "description": "SEC CIK number (e.g. \"320193\" for Apple)"
  },
  "tag": {
   "type": "string",
   "description": "XBRL concept tag (e.g. \"Assets\", \"Revenues\", \"NetIncomeLoss\", \"EarningsPerShareBasic\")"
  },
  "taxonomy": {
   "type": "string",
   "description": "XBRL taxonomy: us-gaap, ifrs-full, dei, or srt"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-sec-company-concept-a5b0e423/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from edgar.mpp.paywithlocus.com](https://www.zero.xyz/host/edgar.mpp.paywithlocus.com/llms.txt)