Skip to content

GET /api/v1/us/companies

US public company metadata.

Returns metadata for US public companies including CIK, ticker, name, exchange, industry, and sector.

Request

GET /api/v1/us/companies

Headers

HeaderValue
F-API-KEYYour API key

Query Parameters

ParameterTypeRequiredFilterDescription
cikstringNoexactSEC CIK
tickerstringNoexactStock ticker
exchangestringNoexactExchange (NYSE, NASDAQ, etc.)
industrystringNoexactIndustry
sectorstringNoexactSector
namestringNolikeCompany name (fuzzy match)
limitintegerNo—Max rows per page (default 100, max 1000)
offsetintegerNo—Rows to skip (default 0)
sortstringNo—Sort field (default ticker)
orderasc | descNo—Sort direction (default asc)

Example

Terminal window
curl -H "F-API-KEY: fk-xxxxx" \
"https://finance-api.xp-java.workers.dev/api/v1/us/companies?ticker=AAPL"

Response

{
"code": 0,
"message": "ok",
"data": [
{
"cik": "0000320193",
"ticker": "AAPL",
"name": "Apple Inc.",
"exchange": "NASDAQ",
"industry": "Consumer Electronics",
"sector": "Technology",
"updated_at": "2024-12-31T00:00:00Z"
}
],
"meta": {
"total": 1,
"limit": 100,
"offset": 0,
"has_more": false
}
}