Skip to main content
GET
/
v1
/
companies
/
{company_id}
Get company by any identifier
curl --request GET \
  --url https://api.ivory.finance/v1/companies/{company_id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "cik": "<string>",
  "external_id": "<string>",
  "external_id_type": "<string>",
  "country_code": "<string>",
  "company_name": "<string>",
  "ticker": "<string>",
  "exchange": "<string>",
  "sector": "<string>",
  "industry": "<string>",
  "sic_code": "<string>",
  "sic_industry": "<string>",
  "sic_sector": "<string>",
  "category": "<string>",
  "is_active": true,
  "listing_date": "2023-12-25",
  "location": "<string>",
  "market_cap": 123,
  "number_of_employees": 123,
  "sec_filings_url": "<string>",
  "website_url": "<string>",
  "weighted_average_shares": 123,
  "events": null,
  "logo_url": "<string>",
  "initials": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt

Use this file to discover all available pages before exploring further.

Company ID formats

The company_id path parameter accepts any of the following formats:
FormatExampleDescription
TICKER:EXCHANGEAAPL:NASDAQ, SHEL:LON, KO:NYSETicker and exchange name (case-insensitive). Best for active listed companies.
CC:external_idGB:00445790, US:00012345672-letter country code + external identifier (CRN, CIK, ISIN, etc.).
UUID3f2a1b4c-...Internal UUID — stable across renames, delistings, and jurisdiction changes.
Bare CIK0001318605US companies only. Zero-padded or plain numeric.
Bare external ID00445790Best-effort match across all jurisdictions. May be ambiguous.
Recommendation: use TICKER:EXCHANGE for active listed companies; use CC:external_id or UUID for private, delisted, or non-US entities.

Authorizations

X-API-Key
string
header
required

Path Parameters

company_id
string
required

Response

Successful Response

id
string | null
cik
string | null
external_id
string | null
external_id_type
string | null
country_code
string | null
company_name
string | null
ticker
string | null
exchange
string | null
sector
string | null
industry
string | null
sic_code
string | null
sic_industry
string | null
sic_sector
string | null
category
string | null
is_active
boolean | null
listing_date
string<date> | null
location
string | null
market_cap
number | null
number_of_employees
integer | null
sec_filings_url
string | null
website_url
string | null
weighted_average_shares
number | null
events
unknown
logo_url
string | null
initials
string | null