Search filings. Read the whole document.

Search company disclosures and get complete processed text in one request. Each result includes the document's sections and tables.

Make a filing search

Use your existing account and credits. Create an API key with filings:search; new keys include this scope. Keys created before Filings Search was introduced need to be replaced.

curl -s https://api.ariselabs-search-api.com/v1/filings/search \
  -H "Authorization: Bearer $ARISELABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "source": "us_sec",
  "query": "data center revenue",
  "ticker": "NVDA",
  "form": "10-K",
  "k": 5
}'

import httpx, os

r = httpx.post(
    "https://api.ariselabs-search-api.com/v1/filings/search",
    headers={"Authorization": f"Bearer {os.environ['ARISELABS_API_KEY']}"},
    json={
        "source": "us_sec",
        "query": "data center revenue",
        "ticker": "NVDA",
        "form": "10-K",
        "k": 5,
    },
    timeout=60,
)
r.raise_for_status()
page = r.json()
for row in page["data"]:
    print(row.get("filed_at", "")[:10], row["title"])

const r = await fetch("https://api.ariselabs-search-api.com/v1/filings/search", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ARISELABS_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "source": "us_sec",
  "query": "data center revenue",
  "ticker": "NVDA",
  "form": "10-K",
  "k": 5
}),
});
if (!r.ok) throw new Error(await r.text());
const page = await r.json();

Choose your query and filters

A successful search costs 3 credits, including full-text retrieval. A failed search or incomplete document retrieval is not charged.

Choose a source

GET /v1/filings/sources lists available sources, query languages, native company identifier formats, common filing types, and supported capabilities. It uses the same key and costs 0 credits. Send queries in the source's language; automatic translation is not part of this API.

ClinicalTrials.gov uses NCT study identifiers. Search by condition, intervention, sponsor, or NCT ID in query; company filters and as_of_date are not supported for this source.

Read the response

Each row in data contains id, source, and the full text. Available metadata includes title, company, entity_id, ticker, form, filed_at, period_end, and language. When available, url links to the original filing. ClinicalTrials.gov results use study_id and sponsor. The returned text is the processed document, including its tables and sections.

search_metadata echoes the query and filters and reports the returned count and elapsed time. usage.credits is the charge for the whole request. Large filings can make responses several megabytes; use a client timeout of at least 60 seconds.

Filing dates and historical availability

since and until filter the filing's date. as_of_date filters when our system observed the document. A historical filing collected later will not appear in an earlier observation snapshot. Use filing dates to find old reports.

Handle failures

• ambiguous_company (400): pick an entity_id from the returned candidates and resubmit.
• invalid_parameter (400): correct the named parameter or an unsupported source/filter combination.
• filing_text_unavailable (503): complete text could not be retrieved for every matched filing. Honor Retry-After before retrying; the failed request is free.

In the console, open Filings from the sidebar. Expand a result to read the full document, or select JSON to inspect the exact API response.