Query syntax, paging and limits
Every search endpoint takes the same request and returns the same shape, so once one works they all do. Queries are Lucene syntax, the same language Elasticsearch and OpenSearch use.
Authentication
Send your key in the Authorization header. A ?token= query parameter works too, for tools that can't set headers, but it ends up in logs, so prefer the header.
curl https://api.quantisnow.com/v1/filings -H "Authorization: $QUANTISNOW_API_KEY" \
-d '{"query": "ticker:MSFT AND formType:\"10-K\""}'Request
{
"query": "issuer.ticker:AAPL AND transactionCodes:S AND filedAt:[2026-01-01 TO 2026-11-17]",
"from": 0,
"size": 50,
"sort": [
{
"filedAt": {
"order": "desc"
}
}
]
}queryis required, up to 3,500 characters.sizeis 1 to 50, default 50.fromis the offset of the first record, 0 to 10,000. Addsizeto it for the next page.sortis a list of{field: {order}}, default newest first by the dataset's date field.
Response
{
"total": { "value": 86, "relation": "eq" },
"data": [ { ... }, { ... } ]
}total.value is exact while relation is eq. Past 10,000 matches it reads 10,000 with relation: "gte", and the rest are out of reach for that query: narrow it, usually by date. The paging guide has a loop that does it.
Query syntax
| What | Write | Notes |
|---|---|---|
| Field match | formType:"10-K" | Quote values with spaces, slashes or dashes. |
| Nested field | issuer.ticker:NVDA | Dots reach into objects and arrays. |
| Any of a list | ticker:(AAPL OR MSFT OR GOOGL) | Up to 1,000 values. |
| And, or, not | formType:4 AND NOT amendment:true | Operators are uppercase. Group with parentheses. |
| Date range | filedAt:[2026-01-01 TO 2026-03-31] | Both ends included. Use { } to leave an end out. |
| Greater or less | purchased.valueUsd:>1000000 | Also >=, < and <= on numbers and dates. |
| Wildcard | companyName:Apple* | * for any characters, ? for one. Not inside quotes. |
| Field exists | _exists_:reportingOwner.officerTitle | Records where the field has a value. |
| Everything | * | Use with a sort and a date range, or you page through the whole index. |
Dates are US Eastern time, like EDGAR. filedAt:[2026-11-03 TO 2026-11-03] is the whole day, and filedAt:[2026-11-03T16:00:00 TO 2026-11-03T20:00:00] is after the close.
Rate limits
| Plan | Requests a second | Plain-English questions |
|---|---|---|
| Trial | 5 | 50 in total |
| Developer | 20 | 500 a month |
| Business | 40 | 5,000 a month |
| Data license | By contract | By contract |
Over the limit you get a 429 with a Retry-After header in seconds. Wait that long and send the request again.
Errors
- 400The query does not parse, or
sizeorfromis out of range. The body says where. - 401No key, or the key is wrong.
- 403The key's plan does not include that endpoint.
- 429Over the rate limit or the month's allowance. See
Retry-After. - 500Our fault. Retry once; if it repeats, tell us the request.
Live stream
wss://api.quantisnow.com/v1/stream pushes every new filing and news item as JSON the moment we have it. Send a query on connect to filter it, in the same syntax:
const ws = new WebSocket("wss://api.quantisnow.com/v1/stream?token=" + key);
ws.onopen = () => ws.send(JSON.stringify({ query: 'formType:("8-K" OR "4") AND ticker:(NVDA OR AMD)' }));
ws.onmessage = (e) => console.log(JSON.parse(e.data));Questions about a field or a query that does not do what you expect: write to quantisnow@quantisnow.com.