Company details

GET/api/company/details

Returns company profile including description, SIC industry/sector classification, fiscal year end, exchange listings, and contact address.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8

Example request

curl 'https://api.stockfit.io/v1/api/company/details?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Detailed company information

Response schema

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

{}

400 Bad Request

Invalid parameters or company not found

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

{}