> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/entities

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

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

<Info>
  Audience: engineers and agents discovering canonical entities before issuer-scoped research.
</Info>

## Canonical metadata

* `data`
* `hasMore`
* `nextCursor`
* `requestId`
* `traceparent`

## Example request

<RequestExample>
  ```bash theme={null}
  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"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "object": "list",
    "data": [
      {
        "id": "cent_example",
        "name": "Example Issuer, Inc.",
        "ticker": "EXAMPLE",
        "cik": "0000000000",
        "entityType": "issuer"
      }
    ],
    "hasMore": false,
    "nextCursor": null,
    "requestId": "req_2ZK8Q1W9F4M6P7R3"
  }
  ```
</ResponseExample>

## 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](/api-reference/entities/get-v1-entities-resolve) 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

<Prompt>
  Use SEC API GET /v1/entities to search canonical SEC entities across issuers, managers, insiders, and funds with offset pagination. Preserve `data`, `hasMore`, `nextCursor`, `requestId`, `traceparent` in the output. Return a concise markdown summary plus the exact structured payload fields that a downstream engineer or agent should keep using this result.
</Prompt>

## 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