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

> Resolve one issuer, manager, insider, or fund from a market or SEC identifier, returning the canonical entity and match confidence

Resolve one issuer, manager, insider, or fund from a market or SEC identifier, returning the canonical entity and match confidence

<Info>
  Audience: engineers and agents normalizing an issuer, fund, manager, or insider before another SEC API call.
</Info>

## Agent mode

Pass `?view=agent` to receive the compact agent shape: entity identifiers (id, ticker, cik, name) + primary identifiers + match metadata. Aliases, jurisdiction, full identifiers list, and metadata envelopes are dropped. See [api conventions → response formats](/api-conventions) for the full `?view=` contract.

## Canonical metadata

* `id`
* `name`
* `ticker`
* `cik`
* `primaryIdentifiers`
* `matchConfidence`
* `matchBasis`
* `requestId`

## 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/resolve?ticker=AAPL&view=agent"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "object": "entity",
    "id": "cent_example",
    "name": "Example Issuer, Inc.",
    "ticker": "EXAMPLE",
    "cik": "0000000000",
    "primaryIdentifiers": [
      {
        "type": "ticker",
        "value": "EXAMPLE"
      },
      {
        "type": "cik",
        "value": "0000000000"
      }
    ],
    "matchConfidence": 1,
    "matchBasis": "ticker",
    "requestId": "req_2ZK8Q1W9F4M6P7R3"
  }
  ```
</ResponseExample>

## Resolution and coverage

Send one stable identifier when possible. `ticker` wins over `symbol`; `name`, `query`, and `q` are fallback aliases, not a guarantee of a unique legal entity. Preserve `matchConfidence` and `matchBasis` before joining this result to filings, facts, or ownership data. See [API conventions](/api-conventions) for identity, response-shape, and request-correlation rules.

## Errors

A blank identifier is `400 missing_identifier`; an identifier that cannot be resolved is `404 entity_not_found`. Do not turn either condition into a guessed ticker or CIK.

## Give this prompt to your agent

<Prompt>
  Use SEC API GET /v1/entities/resolve to resolve one issuer, manager, insider, or fund from a market or SEC identifier, returning the canonical entity and match confidence. Preserve `id`, `name`, `ticker`, `cik`, `primaryIdentifiers`, `matchConfidence`, `matchBasis`, `requestId` 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

* retain `matchConfidence`, `matchBasis`, and `requestId` with the lookup result
* on `400 missing_identifier`, supply one nonblank identifier
* on `404 entity_not_found`, request a corrected identifier instead of guessing