Skip to main content
GET
/
v1
/
search
Full-text search across SEC filings
curl --request GET \
  --url https://api.ivory.finance/v1/search \
  --header 'X-API-Key: <api-key>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ivory.finance/llms.txt

Use this file to discover all available pages before exploring further.

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

Successful Response