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

# Entity Resolution & Mapping API

> Resolve CIK, ticker, FIGI, ISIN, CUSIP, or company name to a best-match SEC entity record with the SEC API entity graph.

Resolve company identifiers -- CIK, ticker, FIGI, ISIN, CUSIP, or company name -- to a best-match SEC entity record with exchange, sector, industry, SIC code, and match details. The entity graph powers identity joins across every other SEC API surface.

## Why use this

Financial data systems break when entity identity is ambiguous. The SEC API Entity Resolution surface maintains an entity graph of issuers, filers, managers, insiders, funds, and aliases so downstream queries do not need to rebuild identity logic on every call.

* **Six identifier types** -- CIK, ticker, FIGI, ISIN, CUSIP, and company name
* **Best-match entity resolution** -- issuers, filers, managers, insiders, funds, and aliases resolved with match details when available
* **Structured metadata** -- exchange, sector, industry, SIC code, and entity type on every record
* **Alias resolution** -- historical tickers, name changes, and cross-identifier mappings
* **Batch-friendly** -- resolve multiple identifiers in a single request

Company names and reused tickers can be ambiguous. For filings-sensitive work, pin requests to CIK or accession number.

## Quick start

```bash theme={null}
# Resolve by ticker
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL"

# Resolve by CIK
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?cik=0000320193"

# Resolve by name
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?name=Apple+Inc"
```

## Example: search entities

```bash theme={null}
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/entities?query=tesla&limit=5"
```

## Response shape

```json theme={null}
{
  "entity": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "name": "Apple Inc.",
    "figi": "BBG000B9XRY4",
    "isin": "US0378331005",
    "cusip": "037833100",
    "exchange": "NASDAQ",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "sicCode": "3571",
    "sicDescription": "Electronic Computers",
    "entityType": "issuer",
    "aliases": [
      { "type": "formerName", "value": "APPLE COMPUTER INC" }
    ]
  }
}
```

## Key parameters

| Parameter | Type   | Description                                    |
| --------- | ------ | ---------------------------------------------- |
| `ticker`  | string | Company ticker symbol                          |
| `cik`     | string | SEC Central Index Key                          |
| `figi`    | string | OpenFIGI identifier                            |
| `isin`    | string | International Securities Identification Number |
| `cusip`   | string | CUSIP identifier                               |
| `name`    | string | Company name (fuzzy matched)                   |
| `query`   | string | Search query for entity listing                |
| `limit`   | number | Results per page (entity search only)          |

## Rate limits

* **Standard plan**: 200 requests/minute
* **Pro plan**: 1000 requests/minute
* **Enterprise**: Custom limits

Entity resolution is a lightweight lookup operation. Rate limits are higher than data-heavy endpoints.

## Related

* [API Reference: Entities](/api-reference/entities)
* [Getting Started](/getting-started)
* [Coverage and Depth](/coverage-and-depth)