Full-Text Search

Full-text search over SEC filing chunk text indexed in OpenSearch. Searches across chunk_text, chunk_heading, and company_name. Use company or cik to drill down to a specific company. Returns matching chunks with query-match highlights (<mark> tags) and a plain-text excerpt fallback. Set `index=transcripts` for hybrid BM25+semantic search over earnings call transcripts, `index=exhibits` for hybrid BM25+semantic search over press releases and investor presentations, `index=ng_filings` for BM25 search over Nigerian Stock Exchange (NGX) filings, `index=gb_fca` for BM25 search over UK FCA filings, `index=gb_ch` for BM25 search over UK Companies House filings, or `index=all` to fan out across all indexes.

GET /v1/search

Full-text search across SEC filings

cURL

curl --request GET \
  --url https://api.ivory.finance/v1/search \
  --header 'X-API-Key: <api-key>'

422

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

X-API-Key · string · header · required

Query Parameters

q · string · required

Search query

Minimum string length: 1

index · string · default: filings

Index to search: filings (SEC, default), transcripts (earnings calls, hybrid), exhibits (press releases & presentations, hybrid), ng_filings (NGX filings, BM25), gb_fca (UK FCA filings, BM25), gb_ch (UK Companies House filings, BM25), or all

company · string | null

Filter by company name or ticker (partial match), e.g. 'Apple' or 'AAPL'

cik · string | null

Filter by CIK (exact match), e.g. '0000320193' — filings only

ticker · string | null

Filter by ticker symbol, e.g. 'AAPL' — transcripts only

form_type · string | null

Filter by form type, e.g. 8-K, 10-K — filings only

from_date · string<date> | null

Earliest date (filing_date for filings, call_date for transcripts)

to_date · string<date> | null

Latest date

limit · integer · default: 20

Required range: 1 <= x <= 100

Response

200

application/json

Successful Response