Companies
Resolve a company name or ticker once, then use its UUID in subsequent requests.
Find companies
Section titled “Find companies”GET /v1/companies?query=KCB&limit=5| Parameter | Type | Required | Rules |
|---|---|---|---|
query |
string | Yes | 2–80 characters after trimming |
limit |
integer | No | 1–20; default 10 |
Search matches literal names and symbols, ignoring case. An exact ticker match is ranked before other matches. This endpoint has no offset parameter.
data is an array containing:
| Field | Meaning |
|---|---|
id |
Stable Fisk company UUID |
name, symbol |
Company name and listing symbol |
sector |
Available sector classification |
exchange, currency |
Exchange code and its currency |
logo_url |
Available company logo URL |
link |
Fisk company page |
An empty array means no active company matched. It does not prove that the issuer does not exist elsewhere.
Read a profile
Section titled “Read a profile”GET /v1/companies/{companyId}| Parameter | Type | Location |
|---|---|---|
companyId |
UUID | Path |
data is an object with id, name, symbol, sector, industry, description, website, issuerWebsite, logoUrl, exchange, currency and link.
The description is limited to 2,000 characters. Missing profile fields remain null. Unavailable or inactive companies return NOT_FOUND.
Integration pattern
Section titled “Integration pattern”Keep the Fisk company UUID and the exchange code in your instrument mapping. Validate mappings against the company name and symbol instead of joining on a ticker alone.
For a branded company header, show the available logo with an accessible company-name fallback. Link out to the original issuer website only when a URL is present.