Skip to main content
POST
Search filings

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Body

application/json
query
string

Keyword search over filing documents. Omit for metadata-only browsing. Quoted phrases without a narrowing metadata filter fall back to keyword search, matching API v1.

Required string length: 1 - 4000
filters
object[]

Filters combine with AND. Values in an in/containsAny filter combine with OR. Dates are inclusive. TOI, SubTOI, outcome and filing type use normalized values.

Maximum array length: 50
sort
object[]

Default: submissionDate descending, matching API v1. Specify relevance descending for relevance ordering. Metadata sorting of text results applies within the retrieved candidate window.

Required array length: 1 - 3 elements
includePassages
boolean

Request matching text passages. Omit to use the configured default; false skips passages but may still return matching document IDs and names. True uses a bounded window of 100 candidate documents; false or omitted permits up to 1,200. Passages and page numbers may be unavailable. Has no effect when browsing without a query.

dataScope
enum<string>

Text queries default to recent (2018+ and undated); metadata-only requests default to all.

Available options:
recent,
historical,
all
limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string
Required string length: 1 - 128

Response

Matching filings and optional evidence.

filings
object[]
required
nextCursor
string | null
required

Null when the available result window is exhausted; text search may have additional corpus matches.

exhaustive
boolean
required

False for bounded text search; true for metadata browsing. No exact corpus total is computed.