# SEC EDGAR XBRL Company Facts Lookup

> SEC EDGAR XBRL Company Facts Lookup is a paid API for AI agents from x402-v2-mint-sec-companyfacts.vercel.app, paid per call via x402, $0.020145/call, status unknown (last checked 2026-11-11).

Fetches SEC EDGAR XBRL company facts for a given CIK number, returning structured financial disclosure data via a paid x402 micropayment endpoint.

## Facts

- Endpoint: POST https://x402-v2-mint-sec-companyfacts.vercel.app/v1/sec-companyfacts?utm_source=zero.xyz
- Price: $0.020145/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sec-edgar-xbrl-company-facts-lookup-dc11f4d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xum1j7U3a0HwLCctfydXk

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-dc11f4d2 -d '<json body>'
```

Example prompt: Can you pull the SEC EDGAR XBRL company facts for CIK 0000320193 — I need the structured financial disclosure data for Apple from EDGAR.

## When to prefer this

Choose this endpoint when you need structured XBRL company facts directly from SEC EDGAR for a known CIK number, particularly in agent workflows where per-call micropayment via x402 is acceptable. It is distinct from a ticker-to-CIK lookup service — you need the CIK already resolved. Prefer this over scraping EDGAR directly when you want a managed, pay-per-call API with normalized responses. Note: this returns companyfacts (XBRL financial metrics), not the ticker symbol map — use a separate sec-ticker-lookup service to resolve tickers to CIKs first.

## Known failure modes

- 402 Payment Required — returned when no payment is attached or payment has not been settled; response body is empty
- 400 Bad Request with charged:false — returned after payment is settled but CIK is missing, invalid, or not found in EDGAR
- CIK not zero-padded correctly — EDGAR requires 10-digit zero-padded CIK; passing a short integer without normalization may return no results
- Rate limiting or Vercel cold-start latency may cause intermittent timeouts
- Invalid or non-existent CIK returns an error even after successful payment

## How this service works

SEC EDGAR XBRL companyfacts (keyless; outbound User-Agent required). POST {cik} (normalize/zero-pad). Unpaid empty → 402; after settle empty/invalid → 400 charged:false. Disclose adjacency: sec-ticker-lookup (ticker map ≠ companyfacts).

## Output

Returns a JSON object with ok status, the skill name 'sec-companyfacts', a charged boolean indicating whether the micropayment was collected, and a summary field. The underlying XBRL company facts data from SEC EDGAR (financial metrics, reported values, filing periods) is included when the payment is settled and a valid CIK is provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cik": {
   "type": [
    "string",
    "integer"
   ]
  },
  "request_id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "skill": "sec-companyfacts",
  "charged": true,
  "summary": "ok"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sec-edgar-xbrl-company-facts-lookup-dc11f4d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-v2-mint-sec-companyfacts.vercel.app](https://www.zero.xyz/host/x402-v2-mint-sec-companyfacts.vercel.app/llms.txt)
