Companies by ID
Fetch one accessible record by public ID at the knowledge cutoff. Includes inactive or expired records. Returns 404 when absent or inaccessible, 503 when dataset coverage is unavailable, and 501 when no source is connected to the dataset.
/v1/companies/{id}- Required capability
- companies.read
- Data timing
- As published by the source
- Credits
- 5 credits per request.
Parameters
effective_datestringoptional · query- Effective date, defaults to the UTC date of as_of. Returns the latest eligible snapshot on or before this date; response retains its actual snapshot date.
as_ofstringoptional · query- Knowledge cutoff as a UTC date (YYYY-MM-DD): the response reflects what was known by the end of that day. Defaults to now; cannot be in the future. A date from before the dataset's knowledge history returns 422 point-in-time-unavailable naming the earliest one, which GET /v1/datasets lists as earliest_as_of.
idstringrequired · path- Stable public record ID.
formatstringoptional · query- Response format. csv returns the data rows with a header row, for spreadsheet functions such as IMPORTDATA; nested fields become dotted columns and lists one JSON array cell, the next page cursor is returned in X-Next-Cursor and meta.errors in X-Meta-Errors. A result without rows is the header row alone, listing the documented fields of a row. Default json, or csv when format is omitted and the Accept header ranks text/csv above JSON; a format the Accept header does not admit returns 406 not-acceptable.
jsoncsv
Response fields
Returns data as an object. All example values are illustrative.
idstring- Opaque stable public identifier; never an internal database key.
namestring- Legal/display company name.
descriptionstring · null- Business description.
country_codestring- country code
sectorstring · null- Sector name, in the connected source's own categories. Null for funds (ETFs and mutual funds), units, warrants and rights, which the source does not classify.
industrystring · null- Industry name, in the connected source's own categories. Null where sector is.
classificationsarray- Coded industry classifications. No coded scheme is connected yet, so the list is empty on every company; sector and industry carry the names.
website_urlstring · null- website url
logo_urlstring · null- Company logo hosted by OHLC, SVG or PNG from the best-ranked source, so read the format from the file extension or Content-Type. It is always the current logo, whatever as_of. The URL changes when the logo changes, so it can be cached indefinitely.
employeesinteger · null- Reported employee count.
addressobject · null- address
officersarray- officers
instrumentsarray- instruments
Response metadata
Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.
When something goes wrong
An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.
Plans
Requires companies.read. Access, recency and history depth come from the plan definitions the API enforces.
| Plan | Access | Recency | History |
|---|---|---|---|
| Free | Included | As published | 5 years |
| Developer | Included | As published | 5 years |
| Pro | Included | As published | 15 years |
| Commercial | Included | As published | Full history |
| Scale | Included | As published | Full history |
Free requests are limited to AAPL, NVDA, JNJ, PEP, MSFT, SPY, QQQ.
History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans