/api/v1/cusip/cusip6/{cusip6}Look up all securities sharing a 6-digit CUSIP issuer prefix.
Look up all securities sharing a 6-digit CUSIP issuer prefix. Returns all 9-digit CUSIPs with matching first 6 characters (same issuer, different securities — common stock, preferred, warrants, etc.).
Why use this
Common use case
Look up all securities sharing a 6-character CUSIP issuer prefix — the broadest issuer-keyed lookup in the CUSIP API. The CUSIP6 prefix groups by ISSUER OPERATIONALLY (CUSIP Global Services-assigned identifier scheme) rather than by SEC CIK, so a single CUSIP6 typically returns more security classes than GET /api/v1/cusip/cik/{cik}. Apple's 037833 returns common stock; Berkshire's 084670 returns both BRK-A and BRK-B; multi-issuer prefixes (rare but possible after corporate actions) return all relevant securities sorted by group priority then alphabetically. Critical caveat: CUSIP6 is NOT a stable issuer identifier across REORGS — when a security goes through a SPAC merger or redomicile, the successor CUSIPs typically have NEW CUSIP6 prefixes (RKLB went G9442R -> 773122 -> 773121). Use GET /api/v1/cusip/chain/{cusip} for chain-aware queries that span historical CUSIPs.
Parameters
| Name | In | Required | Default | Allowed | Description | Example |
|---|---|---|---|---|---|---|
| cusip6 | path | required | — | — | 6-character CUSIP issuer prefix (case-insensitive). Real public-domain examples: `037833` (Apple), `594918` (Microsoft), `02079K` (Alphabet — covers both GOOGL `02079K305` and GOOG `02079K107`), `084670` (Berkshire — covers both BRK-A `084670108` and BRK-B `084670702`). Returns 404 when no securities are registered to the prefix. | 037833 |
Response schema
| Field | Type | Nullable | Description |
|---|---|---|---|
| cusip6 | string | no | Echoed input CUSIP6 (uppercased). |
| issuer_name | string | no | Most-common issuer name across all securities sharing this CUSIP6. For multi-entity prefixes (rare but possible after reorgs) this is the modal name; consult `securities[].issuer_name` for per-CUSIP detail. |
| securities | array | no | Array of all 9-character CUSIPs sharing this issuer prefix. Order: by `security_group` priority then by ticker alphabetical (Stocks first, then ETFs / Preferred / Warrants / Debt / Other). For Apple `037833`: returns common stock; for Berkshire `084670`: returns BRK-A then BRK-B. |
| securities[].cusip | string | no | Full 9-character CUSIP. |
| securities[].ticker | string | yes | Canonical hyphen-form ticker. Null for unmapped securities (debt, private placements). |
| securities[].issuer_name | string | no | Issuer name for THIS specific CUSIP — typically identical to the top-level `issuer_name` field but can vary slightly for amended-filings or post-reorg edge cases. |
| securities[].security_group | string | yes | Security classification — `Stocks` / `ETFs` / `Preferred` / `Warrants` / `Debt` / `Other`. Filter to `Stocks` for common-equity-only views; `Preferred + Warrants` for hybrid-instrument exposure analysis. |
| securities[].cik | string | yes | 10-character zero-padded SEC CIK for the issuer. Typically identical across all securities in the prefix (same legal entity). |
Sample response
- "cusip6": "084670"
- "issuer_name": "BERKSHIRE HATHAWAY INC"
- "securities":
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/cusip6/{cusip6}?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).