# SEC EDGAR XBRL Company Facts Lookup

> SEC EDGAR XBRL Company Facts Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-09-15).

Retrieves all XBRL company facts (us-gaap and dei) for a US public company by SEC CIK number in a single API call.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/suverse-sec-company-facts
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-xbrl-company-facts-lookup-53e1f4d9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_o_sihG4KZDatUeopgD02q

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 sec-edgar-xbrl-company-facts-lookup-53e1f4d9 -d '<json body>'
```

Example prompt: Pull all the SEC XBRL company facts for Apple — CIK 0000320193 — so I can see every us-gaap and dei reported value with periods.

## When to prefer this

Choose this endpoint when you need the complete, structured XBRL financial fact set for a US public company in a single call without managing SEC EDGAR API authentication or pagination. It is ideal for AI agents building financial knowledge bases, running screening models, or performing fundamental analysis where breadth of XBRL coverage across all us-gaap and dei concepts is required. Prefer it over raw SEC EDGAR calls when you want a clean, pre-aggregated JSON response with entity metadata included.

## Known failure modes

- Invalid or non-existent CIK returns an error or empty result
- Company has no XBRL filings (very old or non-reporting entity) returns empty fact set
- SEC EDGAR upstream unavailable causes degraded or failed response
- Malformed request body returns validation error
- Rate limits or payment failure at proxy layer returns 402 or 429

## How this service works

All XBRL company facts for a US public company by SEC CIK in one call from SEC EDGAR: entity name plus the full us-gaap and dei fact set with periods and values. For AI agents pulling complete fundamentals, screening, or seeding a knowledge base.

## Output

A JSON object containing the company entity name, and the complete set of us-gaap and dei XBRL facts including concept names, units, reporting periods (instant or duration), and reported values as filed with SEC EDGAR.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-xbrl-company-facts-lookup-53e1f4d9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)
