Batch lookup by symbols

GET/api/lookup/batch

Returns enriched profiles for multiple ticker symbols in a single request. Up to 50 symbols per request.

Get API key Try it live in the API explorer

Query parameters

symbols string required min length 1 · max length 300

Comma-separated list of ticker symbols (max 50)

Example: AAPL,MSFT,GOOG

Example request

curl 'https://api.stockfit.io/v1/api/lookup/batch?symbols=AAPL%2CMSFT%2CGOOG' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Map of symbol to profile. Missing symbols are omitted from the response.

Response schema

* (additional properties) object
- symbols array of string
  Tickers of the entity's currently active listings, primary first. Positionally aligned with `exchanges` (symbols[i] trades on exchanges[i]); not deduplicated, so a multi-class issuer lists every class.
- exchanges array of string
  Exchange for each ticker in `symbols`, in the same order. Not deduplicated.
- name string
  Company or fund name
- cik integer
  SEC Central Index Key
- seriesId integer
  Series ID (0 for stocks, non-zero for ETF/mutual fund series sharing a CIK)
- type string (enum)
  Security type
  Allowed values: stock, etf, mf
- sector string | null
  Business sector derived from SIC code
- industry string | null
  Industry classification derived from SIC code
- industryGroup string | null
  High-value industry group (Semiconductors, Software & SaaS, Pharma & Biotech, Aerospace & Defense, Automotive, Airlines, Oil & Gas, Fintech & Payments). Null if company is not in one of these groups.
- compositeFigi string | null
  Bloomberg Composite FIGI
- ein integer | null
  Employer Identification Number
- formerNames array of string
  Historical company names
- status string (enum)
  Operating status. `delisted` ONLY when the entity has no active listing left on ANY exchange (it has gone fully dark and no longer trades anywhere we track, including OTC). A company that left a major exchange but still trades over-the-counter reads `operating`; see `priorTickers` for the listings it has left behind.
  Allowed values: operating, delisted
- priorTickers array of object
  Listings the entity no longer trades on (delisted), e.g. a Nasdaq listing left behind after a move to OTC. The currently active listings are in `symbols`/`exchanges`. Empty for entities that never left a listing.
  array of:
  symbol string
  The former ticker on this venue
  exchange string
  The exchange the entity has since left
  lastSeen string (date) | null
  The most recent date (ISO 8601) this former ticker was confirmed active — its last-seen date, i.e. roughly when the entity stopped trading under it. For a clean ticker rename (no SEC Form 25/15 removal filing) this approximates the switchover and may be a recent period-end rather than the exact change date. Null when unknown.

Example response

{
  "AAPL": {
    "symbols": [
      "AAPL"
    ],
    "exchanges": [
      "Nasdaq"
    ],
    "name": "Apple Inc.",
    "cik": 320193,
    "seriesId": 0,
    "type": "stock",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "status": "operating",
    "priorTickers": []
  }
}

400 Bad Request

Invalid parameters

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}