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
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
section | query | string | no | A section key, e.g. 10k.1a, 10q.p1i2, 20f.3d. Required. With section maps: or a section map key (executive_compensation, proposal_2). | |
status | query | comma-separated list of string | no | ok, incorporated_by_reference, combined_with, omitted, reserved, not_found. | |
absence_basis | query | comma-separated list of string | no | none, form_optional, bracketed, amendment_scope. | |
target_kind | query | comma-separated list of string | no | proxy_statement, exhibit, annual_report, other_filing, unknown; only with status=incorporated_by_reference. | |
filed_from | query | date (YYYY-MM-DD) | no | filing_date >= this date (inclusive). | |
filed_to | query | date (YYYY-MM-DD) | no | filing_date <= this date (inclusive). | |
amendments | query | string | no | include | Whether to include amendments. One of: include, exclude, only. |
filing_status | query | comma-separated list of string | no | Status(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. | |
cik | query | string | no | The filing's primary CIK, padded or unpadded. | |
min_confidence | query | string | no | Rule confidence at least this, a number from 0 to 1. | |
flag | query | comma-separated list of string | no | Rows carrying any of these section flags. | |
as_of | query | string | no | Inclusive: 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). | |
order | query | string | no | desc | By filing date. One of: desc, asc. |
limit | query | integer | no | 50 | Page size, 1..1000. |
cursor | query | string | no | Opaque cursor from a previous page's next_cursor; bound to the filters and order. | |
key | query | string | no | With section maps: a section map key, the same as section (summary, background_of_the_merger, executive_compensation, pay_versus_performance, proposal_<n>, ...). | |
from | query | date (YYYY-MM-DD) | no | With a section map key: the same as filed_from. | |
to | query | date (YYYY-MM-DD) | no | With a section map key: the same as filed_to. |
Responses
| Status | Body | Description |
|---|---|---|
200 | SectionSearchList (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (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). |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a SectionSearchList object.
| Field | Type | Required | Description |
|---|---|---|---|
as_of | string | null | no | |
data | array of object | no | |
data[].filing | FilingRef | no | |
data[].form | string | no | |
data[].links | object | no | |
data[].scope_kind | string | no | |
data[].section | Section | no | |
form | string | no | |
has_more | boolean | no | |
next_cursor | string | null | no | |
section | string | no | |
snapshot | Snapshot | no |
Example request
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