GET /v1/entities - SEC API for AI

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/entities?q=example&entity_type=issuer&limit=25"

{
  "object": "list",
  "data": [
    {
      "id": "cent_example",
      "name": "Example Issuer, Inc.",
      "ticker": "EXAMPLE",
      "cik": "0000000000",
      "entityType": "issuer"
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Search canonical SEC entities across issuers, managers, insiders, and funds with offset pagination

Audience: engineers and agents discovering canonical entities before issuer-scoped research.

Canonical metadata

data
hasMore
nextCursor
requestId
traceparent

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/entities?q=example&entity_type=issuer&limit=25"

Example response

{
  "object": "list",
  "data": [
    {
      "id": "cent_example",
      "name": "Example Issuer, Inc.",
      "ticker": "EXAMPLE",
      "cik": "0000000000",
      "entityType": "issuer"
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Pagination and coverage

cursor is a zero-based offset. Follow nextCursor only while hasMore is true; do not derive a cursor from row IDs. The endpoint searches the canonical entity store across supported entity types, so use entity resolution when a workflow needs one authoritative match rather than a result set.

Errors

Invalid limit or cursor values return 400 invalid_query_parameter. Search failures return a contract-aware error rather than a partial list.

Give this prompt to your agent

Failure posture

preserve hasMore and nextCursor when handing pages to another worker
retry only a complete page after transient failures
resolve a selected row before treating it as the final issuer identity

Entities GET /v1/entities/edgar

​Canonical metadata

​Example request

​Example response

​Pagination and coverage

​Errors

​Give this prompt to your agent

​Failure posture

Canonical metadata

Example request

Example response

Pagination and coverage

Errors

Give this prompt to your agent

Failure posture