Batch company details

GET/api/company/details-batch

Returns company profiles for multiple symbols in a single request. Same data as /details but keyed by symbol. Maximum 50 symbols per request.

Get API key Try it live in the API explorer

Query parameters

symbols string required min length 1 · max length 100

Comma-separated list of stock ticker symbols (max 50)

Example: AAPL,MSFT,GOOGL

Example request

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

Responses

200 OK

Map of symbol to company details

Response schema

* (additional properties) object
- name string
  The company name
- cik integer
  The Central Index Key (CIK)
- sic string
  Standard Industrial Classification code
- industry string
  Industry classification
- industryGroup string | null
  High-value industry group classification, or null
- sector string
  Sector classification
- description string
  AI-generated company description, periodically updated.
- fiscalYearEndMonth integer
  Fiscal year end month (1-12)
- fiscalYearEndDay integer
  Fiscal year end day
- symbols array of string
  Tickers of the company'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.
- address string
  Company street address
- city string
  Company city
- state string
  Company state
- zip string
  Company ZIP code
- country string
  Company country
- phone string
  Company phone number
- type string | null
  Security type
- status string (enum)
  Operational state of the issuer. `delisted` means the issuer has no active listing on any exchange. Delisted does NOT mean the company stopped filing with the SEC (delisted issuers often keep filing during deregistration). `operating` otherwise.
  Allowed values: operating, delisted
- webUrl string | null
  Company website URL
- investorRelationsUrl string | null
  Investor relations page URL
- logoUrl string | null
  Company logo URL
- ipoDate string (date)
  IPO / first-effective date (YYYY-MM-DD), derived from the earliest SEC registration-effectiveness filings (Form EFFECT, falling back to the first S-1/F-1/S-11 cluster). The field is omitted entirely when none have been observed (e.g. companies that listed before EDGAR full-text coverage).
- employees object
  Total number of employees from the most recent `dei:EntityNumberOfEmployees` XBRL fact (typically reported on the 10-K cover page, annual cadence). **Coverage is sparse** — only ~2% of SEC filers structurally tag this fact in XBRL. Most filers disclose headcount as prose in 10-K Item 1 (Business) without machine-readable tagging, so the `employees` field is omitted for the majority of companies including some megacaps (AAPL, MSFT, AMZN, GOOGL, META, TSLA all currently omit it). It is also omitted when the most recent count is more than 2 years old (suppressed as stale). When present, `asOf` indicates the period the count is from — annual filers update it once per year, so a count from up to a year ago is normal.
  - count integer
    Reported employee headcount.
  - asOf string (date)
    Period-end date (YYYY-MM-DD) of the filing this count was reported in.
- predecessors array of object
  Prior entities this CIK continues from, detected from the Form 8-K12B successor-issuer declaration (Rule 12g-3). Present only when a succession is on record (e.g. a reincorporation: Marvell Technology, Inc. continues from Marvell Technology Group Ltd.). **Informational pointer only — financials are NOT merged across the link.** The predecessor reported under a different CIK and its history may rest on a different business mix, fiscal basis, or reporting regime; query it separately by its `cik`.
  array of:
  name string
  Legal name of the linked entity.
  cik integer | null
  CIK of the linked entity (null if the entity has no CIK on file).
  relationType string
  Relationship type. Currently always `successor` (Rule 12g-3 succession).
  effectiveDate string (date) | null
  Date the succession took effect (merger effective date or filing date), YYYY-MM-DD.
  corroborated boolean
  True when the predecessor has a Form 15 deregistration on file, corroborating that it genuinely went dark.
- successors array of object
  Entities that continued from this CIK (the reverse of `predecessors`). Present on a now-delisted predecessor so a customer landing on the old CIK can find where it continued. **Informational pointer only — financials are NOT merged.**
  array of:
  name string
  Legal name of the linked entity.
  cik integer | null
  CIK of the linked entity (null if the entity has no CIK on file).
  relationType string
  Relationship type. Currently always `successor` (Rule 12g-3 succession).
  effectiveDate string (date) | null
  Date the succession took effect (merger effective date or filing date), YYYY-MM-DD.
  corroborated boolean
  True when the predecessor has a Form 15 deregistration on file, corroborating that it genuinely went dark.

Example response

{
  "key": {}
}

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

{}