/api/v1/cusip/ticker/{ticker}Resolve Ticker to CUSIP.
Resolve Ticker to CUSIP.
Why use this
Common use case
Reverse direction of GET /api/v1/cusip/lookup/{cusip} — ticker-in, CUSIP-out. The natural bridge from customer-facing ticker UIs into CUSIP-shaped downstream APIs (13F holdings query, batch resolution, etc.). Returns the CURRENT primary CUSIP only — to retrieve historical CUSIPs (e.g. RKLB's pre-SPAC G9442R126 -> post-SPAC 773122106 -> current 773121108 chain) append ?chain=true and use the chain variant. For multi-class issuers (BRK-A vs BRK-B) the result is class-specific — pass each ticker variant separately. Server-side ticker normalization (v3.14.2) coerces BRK.A, BRK/A, BRKA all to BRK-A before lookup.
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| ticker | path | required | — | — | Canonical hyphen-form ticker (`BRK-A` not `BRK.A`). Server-side normalization applies the v3.14.2 ticker-coercion shim — `BRK.A`, `BRK/A`, `BRKA` all coerce to `BRK-A`. Returns 404 when no active CUSIP mapping exists (delisted issuers, foreign tickers without OpenFIGI coverage). | AAPL |
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| ticker | string | no | Echoed canonical ticker (post-normalization to hyphen form). Use for index-matching against the request input. |
| cusip | string | no | 9-character CUSIP for the CURRENT primary security mapped to this ticker. For a ticker like `RKLB` that has been through a SPAC merger, this is the CURRENT CUSIP only — append `?chain=true` to receive the full historical chain instead. For multi-class issuers, this is the most-liquid class only (BRK-A returns the A-class CUSIP, BRK-B returns the B-class CUSIP). |
| issuer_name | string | no | Issuer name from the canonical catalog (all-caps EDGAR convention for SEC-registered issuers — `APPLE INC`). |
| cik | string | yes | 10-character zero-padded SEC CIK of the issuer (e.g. `0000320193`). Null when the issuer has no SEC registration. |
| cusip6 | string | no | 6-character CUSIP issuer prefix. Multi-class issuers share a CUSIP6 (BRK-A `084670108` and BRK-B `084670702` both share `084670`). Use to group across share classes. |
Sample response
- "ticker": "AAPL"
- "cusip": "037833100"
- "issuer_name": "APPLE INC"
- "cik": "0000320193"
- "cusip6": "037833"
Errors
| Status | Label | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad Request | Invalid query, body, or path parameter. |
| 401 | Unauthorized | Missing or invalid Authorization header / api_Token. |
| 402 | Payment Required | Insufficient token balance for this call. Top up |
| 429 | Too Many Requests | Rate limit exceeded for your tier (see /pricing for tier limits). Tier limits |
| 500 | Server Error | Unexpected server-side failure. Retry with backoff; report if persistent. |
Code samples
curl "https://api.finradar.ai/api/v1/cusip/ticker/{ticker}?api_Token=YOUR_API_KEY" \
-H "Authorization: Bearer YOUR_JWT_TOKEN"Generate an API key in /account/credentials to run live queries (literal YOUR_API_KEY placeholder shown until then).