Skip to content

GET /v3/sections

One section across filings, newest first (by filing date, then accession). Default statuses: the placed ones (ok, incorporated_by_reference, combined_with, reserved); omitted and not_found when asked for. absence_basis, target_kind, amendments, min_confidence and flag need cik or filed_from and filed_to at most 366 days apart. as_of: only filings SEC had accepted by then (inclusive; a date is the whole UTC day). With section maps: section (or key) may be a section map key (background_of_the_merger, executive_compensation, pay_versus_performance, proposal_2, ...): that key across merger documents and proxy statements, newest first, filtered by filed_from/from, filed_to/to and cik; limit 1..1000, default 500.

API key: required. See Authentication.

Group: Sections of 10-K, 10-Q and 20-F

Parameters

NameInTypeRequiredDefaultDescription
sectionquerystringnoA section key, e.g. 10k.1a, 10q.p1i2, 20f.3d. Required. With section maps: or a section map key (executive_compensation, proposal_2).
statusquerycomma-separated list of stringnook, incorporated_by_reference, combined_with, omitted, reserved, not_found.
absence_basisquerycomma-separated list of stringnonone, form_optional, bracketed, amendment_scope.
target_kindquerycomma-separated list of stringnoproxy_statement, exhibit, annual_report, other_filing, unknown; only with status=incorporated_by_reference.
filed_fromquerydate (YYYY-MM-DD)nofiling_date >= this date (inclusive).
filed_toquerydate (YYYY-MM-DD)nofiling_date <= this date (inclusive).
amendmentsquerystringnoincludeWhether to include amendments. One of: include, exclude, only.
filing_statusquerycomma-separated list of stringnoStatus(es) of the rows' filings (named apart: status is the section's): provisional, final, deleted, comma-separated (as status of GET /v3/filings). Default: every status, deleted (SEC-withdrawn) filings included; filing_status=final,provisional leaves them out.
cikquerystringnoThe filing's primary CIK, padded or unpadded.
min_confidencequerystringnoRule confidence at least this, a number from 0 to 1.
flagquerycomma-separated list of stringnoRows carrying any of these section flags.
as_ofquerystringnoInclusive: YYYY-MM-DDTHH:MM:SSZ (UTC, through the end of that second), YYYY-MM-DDTHH:MM:SS.ffffffZ (exact, 1-6 fraction digits) or YYYY-MM-DD (the whole UTC day).
orderquerystringnodescBy filing date. One of: desc, asc.
limitqueryintegerno50Page size, 1..1000.
cursorquerystringnoOpaque cursor from a previous page's next_cursor; bound to the filters and order.
keyquerystringnoWith section maps: a section map key, the same as section (summary, background_of_the_merger, executive_compensation, pay_versus_performance, proposal_<n>, ...).
fromquerydate (YYYY-MM-DD)noWith a section map key: the same as filed_from.
toquerydate (YYYY-MM-DD)noWith a section map key: the same as filed_to.

Responses

StatusBodyDescription
200SectionSearchList (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (application/problem+json)Missing, invalid or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728).
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a SectionSearchList object.

FieldTypeRequiredDescription
as_ofstring | nullno
dataarray of objectno
data[].filingFilingRefno
data[].formstringno
data[].linksobjectno
data[].scope_kindstringno
data[].sectionSectionno
formstringno
has_morebooleanno
next_cursorstring | nullno
sectionstringno
snapshotSnapshotno

Example request

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/sections'

Open this route in the console

More in Sections of 10-K, 10-Q and 20-F

Previous: GET /v3/filings/{accession}/sections/{section}/text

Markdown version: /docs/reference/get-sections.md