Skip to content

SEC Blast API documentation

The v3 API serves SEC EDGAR filings as JSON: filings, the documents in them as they were filed, and the entities that file them, under https://api.secblast.com/v3/. The routes that read are GET; the Webhooks (API: callbacks) routes also take POST, PATCH and DELETE.

Routes are relative to https://api.secblast.com/v3.

Pages are generated from the OpenAPI 3.1.0 description.

Quickstart

1. Check that the API is reachable

GET /v3/health needs no key.

Shell
curl -sS 'https://api.secblast.com/v3/health'

Abbreviated response:

JSON
{
  "status": "ok",
  "checks": { "db": "ok", "docs_root": "ok", "store": "ok" }
}

2. Get a key

Sign in. Manage keys under API keys in your dashboard.

3. Make a request

Retrieve the five newest 8-K filings:

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings?form=8-K&limit=5'

The response is a list of filings (three shown, abbreviated). GET /v3/filings returns 50 rows by default, and up to 1000 with limit; use next_cursor only to go past that.

JSON
{
  "data": [
    {
      "accession": "0002057463-26-000023",
      "form_type": "8-K",
      "filing_date": "2026-10-09",
      "items": ["7.01", "9.01"],
      "primary_name": "Liberty Capital Corp/NV",
      "doc_count": 13
    },
    {
      "accession": "0001914496-26-000150",
      "form_type": "8-K",
      "filing_date": "2026-10-09",
      "items": ["3.02", "7.01"],
      "primary_name": "Sculptor Diversified Real Estate Income Trust, Inc.",
      "doc_count": 11
    },
    {
      "accession": "0001903596-26-000372",
      "form_type": "8-K",
      "filing_date": "2026-10-09",
      "items": ["1.01", "5.01", "5.02", "8.01", "9.01"],
      "primary_name": "METROSPACES, INC.",
      "doc_count": 29
    }
  ],
  "has_more": true,
  "next_cursor": "eyJhIjoiMDAwMTkwMzU5Ni0yNi0wMD..."
}

The same request in Python:

Python
import os
import requests

API = "https://api.secblast.com/v3"
session = requests.Session()
session.headers["Authorization"] = f"Bearer {os.environ['SECBLAST_API_KEY']}"

# The five newest 8-K filings, amendments included (the default order is filing_date, newest first).
r = session.get(f"{API}/filings", params={"form": "8-K", "limit": 5}, timeout=30)
r.raise_for_status()
page = r.json()
for filing in page["data"]:
    print(filing["accession"], filing["filing_date"], filing["form_type"], filing.get("primary_name"))

And in TypeScript:

TypeScript
const API = "https://api.secblast.com/v3";
const key = process.env.SECBLAST_API_KEY;

type Filing = { accession: string; filing_date: string; form_type: string; primary_name?: string | null };
type FilingList = { data: Filing[]; has_more: boolean; next_cursor: string | null };

const res = await fetch(`${API}/filings?form=8-K&limit=5`, {
  headers: { Authorization: `Bearer ${key}` },
});
if (!res.ok) {
  // Errors are RFC 9457 problem bodies with a stable `code` and a `request_id`.
  const problem = await res.json();
  throw new Error(`${problem.status} ${problem.code}: ${problem.detail} (request ${problem.request_id})`);
}
const page: FilingList = await res.json();
for (const filing of page.data) {
  console.log(filing.accession, filing.filing_date, filing.form_type, filing.primary_name);
}

4. Read a filing's documents

Each filing in a list carries its accession number. GET /v3/filings/{accession}/documents lists the documents of that filing, and GET /v3/filings/{accession}/documents/{document} returns one document's stored bytes, by sequence number or filename. Replace the accession number below with one from your own list.

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001829126-26-010431/documents'

curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001829126-26-010431/documents/1' \
  -o document.bin

You can also try any route in the browser with the console.

Conventions

  • Lists come in one envelope: { data, has_more, next_cursor }. See Pagination.
  • Errors are RFC 9457 problem bodies (application/problem+json) with a stable code and a request_id. See Errors.
  • Unknown query parameters are rejected with a 400 instead of being ignored, so a misspelled filter cannot silently return unfiltered data.
  • List parameters (for example form) take comma-separated values: form=8-K,10-Q.
  • Dates are YYYY-MM-DD; times are RFC 3339 in UTC.
  • Every response carries an X-Request-Id header. Quote it when you write to support.
  • HEAD and OPTIONS are answered for every path; any other method than GET gets a 405.
  • New filings arrive live with status provisional and become final overnight.
  • The snapshot block. Responses that can carry values from the SEC's submissions snapshot (acceptance time, report period, entity records, the SEC's filing lists, tickers) include snapshot: { available, date }. When available is false the response was built from the v3 database alone.

Routes

The API has 82 routes. Each one is described in the Reference.

RouteReturnsKey
GET /v3/callbacks/deliveriesThe organization's webhook deliveries, newest first (created_at, then id), with the attempt count, the last status and error, when the next attempt is due (only while pending) and the bytes billed.Required
GET /v3/callbacks/deliveries/{id}One delivery of the organization with its payload and every attempt (n, at, duration_ms, http_status, error_class, remote_ip, response_excerpt), oldest first.Required
POST /v3/callbacks/deliveries/{id}/retryQueues one more attempt of a failed delivery now (202, the delivery): it becomes pending and its attempts are not reset.Required
GET /v3/callbacks/endpointsThe organization's webhook endpoints, newest first, with limits.endpoints (the plan's limit and the active endpoints), each with its health and last 24 hours of deliveries.Required
POST /v3/callbacks/endpointsCreate a webhook endpoint.Required
GET /v3/callbacks/endpoints/{id}One webhook endpoint of the organization.Required
PATCH /v3/callbacks/endpoints/{id}Change a webhook endpoint.Required
DELETE /v3/callbacks/endpoints/{id}Delete a webhook endpoint.Required
POST /v3/callbacks/endpoints/{id}/replayQueues again the failed and dropped deliveries of one endpoint created in a window (202 {replayed, truncated, last_created_at}): oldest first, at most 10,000 a call (truncated; continue with from = last_created_at).Required
POST /v3/callbacks/endpoints/{id}/rotate-secretRotate the endpoint's signing secret.Required
POST /v3/callbacks/endpoints/{id}/testSends the endpoint one sample event of a type it takes, signed like any event, with test: true in its envelope and sample data (accession 0000000000-26-000001), and answers with the attempt's outcome: 200 {id, state, delivered, http_status, error_class, duration_ms} once the one attempt is made (a test send is not retried and not billed), or 202 {id, state} when no attempt was made within 12 seconds (it is still sent; see the delivery log).Required
POST /v3/callbacks/endpoints/{id}/verifySends the endpoint a new verification challenge (202, the endpoint): it is unverified, and its deliveries are held, until it answers 2xx with exactly the challenge.Required
GET /v3/companiesCompanies that are or were SPACs (blank checks, SIC 6770), from the SIC and names in their filing headers over time.Required
GET /v3/companies/{cik}/periodsOne concept by fiscal period.Required
GET /v3/companies/{cik}/segmentsThe company's breakdowns by period from its own dimensional facts: business segment, product or service, geography and major customer; revenue, operating income, assets, long-lived assets, D&A, capital expenditure and (from 2024) segment expenses.Required
GET /v3/companies/{cik}/standardThe company's standard fields by period (fields x periods), from each filing's own statements through a pinned concept map: each value with its status (ok, not_reported, ambiguous, not_applicable; a blank is never a zero), the facts behind it, the rule (candidate:<priority> or rollup), the map version and fingerprint, and flags (failed identities, scale outliers).Required
GET /v3/companies/{cik}/statementsA company's statement as presented in its latest periodic report (10-K, 10-Q, 10-KT, 10-QT, 20-F, 40-F and amendments) SEC had accepted by as_of that has one: of one kind (with its parentheticals), of one menu category (notes, details, ...) or one role URI; limit > 1 gives the previous reports' too, newest first.Required
GET /v3/coverageIngest coverage: per feed day the latest non-superseded ingest run and the newest complete reconcile run, overall totals, and the snapshot store.Required
GET /v3/coverage/countThe live filing count, in one small answer that needs no key, for polling: filings (final and provisional; deleted filings are not counted), provisional, deleted, documents, the newest acceptance time and, when this deployment has live ingest, the live daemon's latency over its day.Not needed
GET /v3/coverage/summaryWhat v3 holds, in one answer that needs no key: filings by status, documents, document versions, the feed days ingested (first, last, count), filings per filing-date year, amendment links by status, the known coverage gaps (a list maintained by hand) and, when this deployment has live ingest, the live daemon's state and lag.Not needed
GET /v3/datasetsThe catalogue of parsed datasets: per dataset its extractor, forms, deployed version, derive steps, tables, status (available or in_preparation), coverage (the first and last filing date of successful results: a range, not a statement that every filing in it is parsed), estimated row counts, when it last changed, and its parse queue.Not needed
GET /v3/entitiesEntity search.Required
GET /v3/entities/{cik}Most recent as-filed attributes of a CIK, SEC's current entity record from the snapshot (current), roles seen and filing counts.Required
GET /v3/entities/{cik}/filingsSEC's own filing list for the entity (from the submissions snapshot), newest first; each row says whether v3 has the filing.Required
GET /v3/events/8k/{item}One 8-K item's structured events across filings, newest first (by filing date, then accession): one row per filing with its events of that item, each a list of fields {value, value_as_found, span, rule_id, rule confidence} read from the item's text; exhibit numbers joined to the filing's documents by type.Required
GET /v3/events/itemsOne 8-K item across filings, newest first (by filing date, then accession): the parsed union of header and body items, with which side named it.Required
POST /v3/feedbackSend feedback to SEC Blast.Required
GET /v3/filingsSearch filings.Required
GET /v3/filings/{accession}One filing with entities, documents, events and its version chain.Required
GET /v3/filings/{accession}/13fA 13F filing's cover page (contact fields: city, state or country, ZIP code; no street line, no phone), summary page, both lists of other managers, the unit decision of its values (value_unit) and its step in the manager-period's amendment ledger.Required
GET /v3/filings/{accession}/13f/holdingsThe information-table rows of a 13F filing exactly as filed, in document order, with value_usd = value_reported x the unit decision's multiplier (null when the unit is ambiguous or not decided).Required
GET /v3/filings/{accession}/144A Form 144 notice (or 144/A) as filed: issuer with address and phone, seller (CIK from the SEC header's reporting owner; the form names the seller only), relationships, the securities proposed to be sold with broker and approximate sale date, how they were acquired, the seller's sales of the past three months, plan adoption dates, and the notice's amendment chain on previousAccessionNumber (provisional).Required
GET /v3/filings/{accession}/documentsDocuments of a filing, in sequence order.Required
GET /v3/filings/{accession}/documents/{document}Stored bytes of one document.Required
GET /v3/filings/{accession}/documents/{document}/textThe extracted text of one document as the full-text index holds it (text/plain; charset=utf-8): the text that snippet start/end offsets count characters of.Required
GET /v3/filings/{accession}/eventsLifecycle events of a filing, oldest first.Required
GET /v3/filings/{accession}/factsEvery XBRL fact of a filing as filed: every instance read (the SEC-extracted one when there is one, else the filer's), facts numbered across them in reading order, each with its concept, context (entity, period, dimensions), unit, the exact value beside the filed text, decimals as filed (INF kept), nil, its duplicate class, and footnotes.Required
GET /v3/filings/{accession}/formdOne Form D notice of an exempt offering as filed: offering (industry, exemptions, first sale, securities, minimum investment, the total offering amount, amount sold and remaining -- whole dollars, or Indefinite as filed -- investors, commissions, finders' fees, proceeds to related persons), every issuer, the related persons, the sales compensation recipients with their states, the header entities, and the offering chain (a D/A restates the whole notice: the chain's latest member is the offering).Required
GET /v3/filings/{accession}/headerThe stored SGML header (_header.sgml) as text/plain.Required
GET /v3/filings/{accession}/itemsAn 8-K's item sets (the header's, the body's, their union), how they differ, one row per item (source, heading status, spans in the primary document, rule confidence) and the Item 9.01 exhibit rows.Required
GET /v3/filings/{accession}/items/{code}/textOne 8-K item's canonical text (not the filed HTML), cut from the stored primary document only when the document model and the exact bytes are at hand; otherwise text_status says why.Required
GET /v3/filings/{accession}/nportOne N-PORT report as filed: registrant, series, share classes, report date, total assets, liabilities and net assets, monthly flows (sales, reinvestment, redemption) and other gains, monthly total returns per class, its place in the report ledger (an NPORT-P/A restates the whole report: one filing per series and report date is effective), and a page of its holdings in document order: identifiers (CUSIP classified -- a placeholder is never a CUSIP -- ISIN, ticker, LEI, other), balance, units, currency, value in USD, percent of net assets, asset and issuer categories, country, fair value level, and debt, repo, derivative and lending detail as filed.Required
GET /v3/filings/{accession}/ownershipA Form 3, 4 or 5 (or its /A) as filed: the document's filing-level fields, the issuer, every reporting owner with the whole address and relationship, the SEC header's entities (addresses and phone numbers), the four tables (non-derivative and derivative transactions and holdings) with each row's footnote references and footnote text, the footnotes, the signatures, and the filing's amendment chain (provisional).Required
GET /v3/filings/{accession}/parsedWhich parsed datasets apply to the filing (13f, 8k_items, sections) and the state of each: status (ok, ok_with_warnings, partial, unparseable, not_applicable; pending, failed or not_parsed while there is no result), the extractor version that last verified the filing and the deployed one, a re-parse in progress, warnings (at most 100), the documents read, the dataset's derive steps for the filing, and a link to the dataset's route for the filing (null while this server does not answer it).Required
GET /v3/filings/{accession}/parsed/changesEvery earlier version of the filing's parsed data that is kept, newest first: each row of a dataset table a re-parse changed or removed (kind superseded: table, row key, from and to version, reason changed / removed / withdrawn, the old row), each group of rows rebuilt or replaced as a whole (kind replaced: the 13F ledger and manager-period rows, the filing's warning set and result row; the old rows) and each 13F unit decision (kind unit_decision).Required
GET /v3/filings/{accession}/sectionsThe sections of a 10-K, 10-Q or 20-F: one row per item in force with its key (10k.1a, 10q.p1i2, 20f.3d), status (ok, incorporated_by_reference, combined_with, omitted, reserved, not_found), why an absent item is absent, spans and rule confidence; the amendment scope.Required
GET /v3/filings/{accession}/sections/{section}/textOne section's canonical text, under the same serving rule, paging, ETag, cache and time limit as an 8-K item's text.Required
GET /v3/filings/{accession}/statementsThe filing's statements as presented: every role of the filing (with its R page), and for the roles asked -- by default the statement and cover roles; kind, category, role_no or role_uri name others, notes, policies, tables and details included -- the presentation tree in the filer's order with preferred labels, negating / total / period start and end flags, its calculation arcs, and the columns and cells assembled from the filing's facts (each cell the filed fact: exact value and filed text; a blank is null, never zero; a text block's cell says where its text is).Required
GET /v3/filings/{accession}/statements/rolesThe filing's roles without their statements: every role (statements, cover, notes, policies, tables, details) in position order, with its menu category, statement kind, R page, tree size and matches_sec_render, and a link to its statement.Required
GET /v3/filings/{accession}/tablesThe tables of a 10-K, 10-Q or 20-F primary document.Required
GET /v3/filings/{accession}/versionsVersion chain of the filing's report: the original and every amendment, with how each amendment was linked.Required
GET /v3/financials/factsOne company's facts of one concept across its filings, newest period first (then accession, fact_seq): every fact as filed, with its filing's form, filing date and acceptance time.Required
GET /v3/financials/framesOne concept and period across companies: each company's latest incarnation known at as_of (one per CIK, unit and dimension set), from one index range per filing year, the period being the filed dates.Required
GET /v3/financials/seriesOne company's values of one concept, point in time.Required
GET /v3/financials/standardOne standard field across companies for a calendar frame (CY2024Q4, CY2024; CY2024Q4I for balance-sheet fields): each company's reported value (view latest as of a time, or first_reported) with its facts, rule, map pin and flags; in a quarter frame, a company without a reported quarter gets its quarter derived from its year, nine months, half or first quarter on one basis (monetary flows); ttm=true gives the trailing twelve months ending in the quarter.Required
GET /v3/formsForm types present (deleted filings excluded) with filing counts, most frequent first.Required
GET /v3/funds/holdingsThe N-PORT holdings of one security across funds, newest filing first: exactly one of cusip (only rows whose filed CUSIP is nine characters), isin or ticker (the holding's identifiers as filed).Required
GET /v3/funds/{series_id}/reportsA fund series' N-PORT reports, newest report date first.Required
GET /v3/healthLiveness: one database round trip, the document root, and whether the snapshot store is usable.Not needed
GET /v3/offeringsForm D notices across filings, newest first (filing date, accession).Required
GET /v3/openapi.jsonThis OpenAPI 3.1 document.Not needed
GET /v3/ownership/insiders/holdingsForms 3/4/5 holding rows (Table I and Table II) across filings, newest filing first, then table and row, with the same filing, issuer, owner and footnote members and the same views as the transactions route.Required
GET /v3/ownership/insiders/transactionsForms 3/4/5 transaction rows (Table I and Table II) across filings, newest filing first, then table and row.Required
GET /v3/ownership/institutional/holdersThe effective 13F rows of one CUSIP across managers for one period (as known at as_of), ordered by manager CIK, ledger step and row; options are their own rows.Required
GET /v3/ownership/institutional/managers/{cik}/holdingsA 13F manager's holdings for one period: view=effective applies the amendment ledger (the last restatement or original, plus later additions) as known at as_of; view=as_filed lists the rows of every applied step.Required
GET /v3/ownership/institutional/managers/{cik}/periodsOne row per period a 13F manager filed for, newest first: ledger steps, base and latest filing, effective rows and reported 13F long value (not assets under management), flags.Required
GET /v3/ownership/proposed-salesForm 144 notices across filings, newest first, each with its securities, acquisitions and past sales.Required
GET /v3/reportsReports of one entity: one row per version chain (an original plus its amendments), ordered by the original filing's date, newest first (a chain whose original is not ingested is dated by its first ingested amendment).Required
GET /v3/resolveWhich CIK(s) hold a ticker, from SEC's ticker file; with as_of, from the copy that was current on that date.Required
GET /v3/searchFull-text search over every document v3 holds (spec ยง6.1).Required
GET /v3/search/parseHow a query is read, without running it: the normalised query, its tree, the EDGAR reading beside the default one, prefix expansions, the structured filters after alias mapping and ticker resolution, and the index years it would touch.Required
GET /v3/search/statusState of the full-text index, without a key: per year the document and filing counts, index version and extractor; the live indexer's lag; indexed_through; the years being rebuilt.Not needed
GET /v3/search/subscriptionsThe organization's subscriptions, newest first, with limits by kind: filter (stored kind filing), firehose and search, each the plan's limit and the active subscriptions.Required
POST /v3/search/subscriptionsCreate a search subscription.Required
GET /v3/search/subscriptions/{id}One subscription of the organization.Required
PATCH /v3/search/subscriptions/{id}Change a search subscription.Required
DELETE /v3/search/subscriptions/{id}Delete a search subscription.Required
POST /v3/search/subscriptions/{id}/testPreview a search subscription: the payloads the subscription would have produced for filings accepted in the last 7 days (at most 5, newest first), as webhook envelopes with test: true; nothing is delivered or recorded.Required
GET /v3/sectionsOne section across filings, newest first (by filing date, then accession).Required
GET /v3/streamThe filing stream: a cursor long-poll over every new, updated, corrected and deleted filing.Required
GET /v3/stream/statusStream state: the head cursor, live ingest state, sequencer lag and latency percentiles of the last hour and day.Not needed
GET /v3/usageThe calling key's limits and this month's usage: requests and billable response bytes (measured before compression; 5xx and 429 not billable) of its organization and of the key itself, what is left of the monthly allowance, when it starts again, and which limits are enforced.Required

For language models and tools

Markdown version: /docs/overview.md