Skip to main content
POST
Retrieve companies by natural language query (v2)

Authorizations

X-API-Key
string
header
required

Body

application/json

Natural language query to find companies

query
string
required

The natural language query

Minimum string length: 1
documentIds
string | null

Comma-separated string of document file IDs. If provided and non-empty, skips document and company selection and goes directly to retrieval.

Response

Companies retrieved successfully

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