SEC API docs ▾

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.

shell
curl https://api.quantisnow.com/v1/filings -H "Authorization: $QUANTISNOW_API_KEY" \
  -d '{"query": "ticker:MSFT AND formType:\"10-K\""}'

Request

POST body
{
  "query": "issuer.ticker:AAPL AND transactionCodes:S AND filedAt:[2026-01-01 TO 2026-11-17]",
  "from": 0,
  "size": 50,
  "sort": [
    {
      "filedAt": {
        "order": "desc"
      }
    }
  ]
}
  • query is required, up to 3,500 characters.
  • size is 1 to 50, default 50.
  • from is the offset of the first record, 0 to 10,000. Add size to it for the next page.
  • sort is a list of {field: {order}}, default newest first by the dataset's date field.

Response

200 OK
{
  "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

WhatWriteNotes
Field matchformType:"10-K"Quote values with spaces, slashes or dashes.
Nested fieldissuer.ticker:NVDADots reach into objects and arrays.
Any of a listticker:(AAPL OR MSFT OR GOOGL)Up to 1,000 values.
And, or, notformType:4 AND NOT amendment:trueOperators are uppercase. Group with parentheses.
Date rangefiledAt:[2026-01-01 TO 2026-03-31]Both ends included. Use { } to leave an end out.
Greater or lesspurchased.valueUsd:>1000000Also >=, < and <= on numbers and dates.
WildcardcompanyName:Apple** for any characters, ? for one. Not inside quotes.
Field exists_exists_:reportingOwner.officerTitleRecords 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

PlanRequests a secondPlain-English questions
Trial550 in total
Developer20500 a month
Business405,000 a month
Data licenseBy contractBy 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 size or from is 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:

javascript
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.

Tell us what you're building and get a key

A person reads every request and answers within one business day. Approved keys start with 1,000 free calls.

Quantisnow is not affiliated with or endorsed by the U.S. Securities and Exchange Commission. EDGAR is the SEC's filing system; the filings themselves are public records.