# EDGAR Company Facts (XBRL Concepts)

> EDGAR Company Facts (XBRL Concepts) is a paid API for AI agents from agent402.tools, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns all XBRL financial concepts reported by a US public company to the SEC, with optional full time-series for specific tags.

## Facts

- Endpoint: GET https://agent402.tools/api/edgar-company-facts
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/edgar-company-facts-xbrl-concepts-05ce9d40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1yVtoZLo1lpBVnzE_biSu

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-company-facts-xbrl-concepts-05ce9d40
```

Example prompt: Pull all the XBRL financial facts Apple has reported to the SEC — specifically the full time-series for Revenues, Assets, and NetIncomeLoss — using ticker AAPL.

## When to prefer this

Use this endpoint when you need structured, authoritative SEC-sourced XBRL financial data for a US public company — especially for time-series analysis of specific accounting concepts like Revenues, Assets, or NetIncomeLoss. Prefer over full-text EDGAR search when you need machine-readable numeric data rather than document content.

## Known failure modes

- Unknown ticker or CIK returns 404 or empty result
- Invalid tag names return no time-series data for those concepts
- Very large responses (full facts without tag filter) may be slow or truncated
- Rate limiting or payment failure returns 402 or 429
- Non-US companies or non-reporting entities will return no data

## How this service works

All XBRL concepts reported by a company. Default returns a compact summary per tag (label, unit, latest value, latest end date) - typically a few hundred KB. Pass tags=Revenues,Assets,NetIncomeLoss to get full time-series for just those concepts. Source: data.sec.gov/api/xbrl/companyfacts. ?ticker=AAPL

## Output

A compact summary (or full time-series if specific tags are requested) of every XBRL concept the company has filed with the SEC, including concept labels, units, latest values, and end dates. When tags are specified, returns complete historical series for only those concepts.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "cik": {
       "type": "string",
       "description": "SEC CIK number (alternative to ticker)"
      },
      "tags": {
       "type": "string",
       "description": "Optional comma-separated tag list - when set, returns full time series for ONLY these tags (e.g. Revenues,Assets,NetIncomeLoss)"
      },
      "ticker": {
       "type": "string",
       "description": "US stock ticker (alternative to cik)"
      },
      "taxonomy": {
       "type": "string",
       "description": "Optional taxonomy filter, e.g. \"us-gaap\" or \"dei\""
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "cik",
      "entityName",
      "mode",
      "taxonomies"
     ],
     "properties": {
      "cik": {
       "type": "string"
      },
      "mode": {
       "type": "string"
      },
      "entityName": {
       "type": "string"
      },
      "taxonomies": {
       "type": "object",
       "properties": {
        "us-gaap": {
         "type": "object",
         "properties": {
          "count": {
           "type": "integer"
          },
          "sample": {
           "type": "object",
           "properties": {
            "Revenues": {
             "type": "object"
            }
           }
          }
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cik": "0000320193",
  "mode": "summary",
  "entityName": "Apple Inc.",
  "taxonomies": {
   "us-gaap": {
    "count": 312,
    "sample": {
     "Revenues": {
      "unit": "USD",
      "label": "Revenues",
      "latestEnd": "2024-09-28",
      "latestVal": 391035000000,
      "observations": 48
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/edgar-company-facts-xbrl-concepts-05ce9d40/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)