---
title: "Search entities"
method: GET
path: "/v1/entities"
---

# Search entities

`GET /v1/entities`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/entities`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

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

## Query parameters

- `q` string
- `entity_type` string
- `limit` integer
- `cursor` integer

## Response `200`

Canonical entity search page. The envelope always includes pagination, request correlation, and nullable query-path metadata.

- object
  - `object` 'list', required
  - `data` object[], required
    - `object` 'entity'
    - `id` string
    - `entityType` string
    - `ticker` string, nullable
    - `cik` string, nullable
    - `name` string
    - `aliases` string[]
    - `identifiers` object[]
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required: The next zero-based offset cursor, or null when the current page is terminal.
  - `queryPath` string, nullable, required
  - `queryPathReason` string, nullable, required
  - `policyYears` object, nullable, required
  - `degradedState` object, nullable, required
  - `requestId` string, required
  - `traceparent` string, required

## Other responses

- `400`: Invalid limit or cursor. Both routes require limit from 1 through 50 and a non-negative integer cursor.
- `502`: The entity source could not complete the search (entity_search_failed).
- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)