Skip to main content
POST
/
api
/
v1
/
rag
/
company-retrieval
Retrieve companies by natural language query
curl --request POST \
  --url https://rest-api.captide.co/api/v1/rag/company-retrieval \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "query": "<string>",
  "documentIds": "<string>"
}
'
[
  {
    "id": "91f6c6da-478f-4161-b451-aa5177cc7fb9",
    "name": "Apple Inc.",
    "tickers": [
      "AAPL"
    ],
    "countries": [
      "US"
    ],
    "filesWithSec": true,
    "cik": "320193",
    "permid": "4295905573"
  }
]

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