# vaaya.ai SEC EDGAR Entity Search (CIK Lookup)

> vaaya.ai SEC EDGAR Entity Search (CIK Lookup) is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-03).

Resolves a company or fund name fragment to SEC EDGAR registrant CIKs using the autocomplete index, returning ranked entities with their CIK identifiers.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/edgar/entities?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-ai-sec-edgar-entity-search-cik-lookup-a214e83f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TCZqtINI-Le1VriaYzjhc

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 vaaya-ai-sec-edgar-entity-search-cik-lookup-a214e83f -d '<json body>'
```

Example prompt: What's the SEC EDGAR CIK for Berkshire Hathaway? I need to look up their filings.

## When to prefer this

Use this endpoint as the first step for any company-scoped SEC EDGAR workflow — it is the authoritative way to map a brand or fund name to the CIK needed by all other EDGAR endpoints. Prefer this over full-text search when you need to confirm a legal entity's existence, find SPV families, or prove a company has never registered. Not suitable for searching SEC filing content or documents directly.

## Known failure modes

- No matching entities found for obscure or misspelled names — returns empty results
- Ambiguous name fragments may return many unrelated entities requiring further filtering
- Private companies that have never filed with the SEC will not appear in results
- Rate limiting or payment failure via x402 protocol may block requests

## How this service works

SEC EDGAR entity search: company/fund name → registrant CIKs (the autocomplete index). Pass `q` (name fragment). Returns ranked entities with CIK. START HERE for any company-scoped EDGAR question — resolves brand → legal entity, finds SPV families, and proves "never registered" negatives that full-text search cannot.

## Output

A ranked list of SEC EDGAR registrant entities matching the name fragment, each with the entity's legal name and CIK (Central Index Key). Can be used directly to query filing history, full-text search, or document retrieval endpoints.

## 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": {
     "type": "object",
     "$schema": "http://json-schema.org/draft-07/schema#",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "minLength": 1
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "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/vaaya-ai-sec-edgar-entity-search-cik-lookup-a214e83f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)
