Skip to main content
GET
/
api
/
v1
/
companies
/
search
Search companies (type-ahead)
curl --request GET \
  --url https://rest-api.captide.co/api/v1/companies/search \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": "77848abe-a215-41b7-8950-86e89ea1fadc",
    "name": "Santos Ltd.",
    "tickers": [
      "STO.AX"
    ],
    "countries": [
      "AU"
    ],
    "filesWithSec": false,
    "permid": "4295857141"
  }
]

Authorizations

X-API-Key
string
header
required

Query Parameters

q
string
required

Search query: company name or ticker (e.g. 'Apple', 'AAPL', 'STO.AX')

Minimum string length: 1
limit
integer | null
default:20

Maximum number of results (type-ahead)

Required range: 1 <= x <= 50

Response

Search results

id
string
required

Unique company ID

name
string
required

Company name

tickers
string[]
required

List of ticker symbols with exchange suffixes (e.g., 'ASML', 'ASML.AS')

countries
string[]
required

Company's country of domicile (ISO 3166-1 alpha-2)

filesWithSec
boolean
required

Whether the company files reports with the SEC

cik
string | null

Central Index Key (CIK) assigned by the SEC

permid
string | null

PermID (Permanent Identifier) assigned by Refinitiv