# EDGAR XBRL Financial Concept Lookup

> EDGAR XBRL Financial Concept Lookup is a paid API for AI agents from edgar.openverbs.com, paid per call via x402, $0.006/call, status unknown (last checked 2026-09-13).

Retrieves a single XBRL financial concept (e.g. Revenues, NetIncomeLoss, Assets) for a company from SEC EDGAR as-filed statements, returning recent datapoints with values, periods, and filing metadata.

## Facts

- Endpoint: POST https://edgar.openverbs.com/v1/facts
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edgar-xbrl-financial-concept-lookup-7fbb1048
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GsqUkXFRXqOV_cw9E4_iE

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-xbrl-financial-concept-lookup-7fbb1048 -d '<json body>'
```

Example prompt: Pull the last 8 datapoints for NetIncomeLoss from Apple's SEC EDGAR filings using their ticker AAPL under the us-gaap taxonomy.

## When to prefer this

Use this endpoint when you need precise, as-filed XBRL financial data for a specific concept directly from SEC EDGAR — ideal for auditable, point-in-time financial research, compliance checks, or building financial models from primary regulatory sources. Prefer this over third-party financial data APIs when you need the exact values as originally reported to the SEC, with full filing provenance (form type, accession number, filing date). Best for single-concept, single-company lookups; for bulk or multi-concept queries, consider batch alternatives.

## Known failure modes

- Unknown ticker or CIK returns a not-found error
- XBRL concept tag not present in the company's filings returns empty or null results
- Taxonomy mismatch (e.g. using us-gaap for an IFRS filer) yields no data
- Limit out of range (below 1 or above 50) triggers a validation error
- Malformed concept tag returns an error or empty dataset
- Network or EDGAR upstream outage causes a timeout or 5xx response

## How this service works

Read a single XBRL financial concept for a company (by CIK or ticker) from its as-filed statements. Give the concept's XBRL tag (e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted) and optionally the taxonomy (default us-gaap, also dei). Returns the label and, per unit (USD, shares), recent datapoints with period end, value, fiscal year/period, form, filing date and accession. Bounded, as-reported output.

## Output

Returns the concept's human-readable label and, grouped by unit (e.g. USD, shares), a list of recent as-filed datapoints each containing: period end date, reported value, fiscal year, fiscal period, SEC form type (e.g. 10-K, 10-Q), filing date, and accession number. Data is bounded to the requested limit, ordered most recent first.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string",
       "minLength": 1,
       "maxLength": 10,
       "description": "Central Index Key (1-10 digits). Provide this or `ticker`."
      },
      "ticker": {
       "type": "string",
       "minLength": 1,
       "maxLength": 10,
       "description": "Ticker symbol, e.g. \"AAPL\". Provide this or `cik`."
      },
      "taxonomy": {
       "type": "string",
       "minLength": 1,
       "maxLength": 20,
       "default": "us-gaap",
       "description": "XBRL taxonomy, usually \"us-gaap\" (also \"dei\", \"ifrs-full\")."
      },
      "concept": {
       "type": "string",
       "minLength": 1,
       "maxLength": 80,
       "description": "XBRL concept tag, e.g. \"Revenues\", \"NetIncomeLoss\", \"Assets\"."
      },
      "limit": {
       "type": "integer",
       "minimum": 1,
       "maximum": 50,
       "default": 8,
       "description": "Max datapoints per unit, most recent first (default 8)."
      }
     },
     "required": [
      "concept"
     ],
     "additionalProperties": false
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-xbrl-financial-concept-lookup-7fbb1048/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from edgar.openverbs.com](https://www.zero.xyz/host/edgar.openverbs.com/llms.txt)