Retrieve companies by natural language query (v2)

curl --request POST \
  --url https://rest-api.captide.co/api/v2/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"
  }
]

Agentic RAG

Company Retrieval

Retrieves a list of companies from the Captide database based on a natural language query. This endpoint uses Captide’s RAG system to understand company names, tickers, or informal references and returns matching companies with their full details.

Example queries:

“Give me Estee Lauder and Louis Vuitton”
“Show me Apple and Microsoft”
“Find companies with tickers AAPL and MSFT”

This v2 endpoint is functionally identical to v1. It is provided for API version consistency.

POST

api

rag

company-retrieval

Retrieve companies by natural language query (v2)

curl --request POST \
  --url https://rest-api.captide.co/api/v2/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

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

Get Document by ID Chunk Retrieval