Skip to content

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

One section's canonical text, under the same serving rule, paging, ETag, cache and time limit as an 8-K item's text. With section maps: {section} may be a section map key of a merger document or proxy statement (risk_factors, proposal_2, unmapped_7).

API key: required. See Authentication.

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

Parameters

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number, with dashes (0001829126-26-010431) or without (18 digits).
sectionpathstringyesA section key, e.g. 10k.1a, 10q.p1i2, 20f.3d.
offsetqueryintegerno0Byte offset in the section's text, 0..text_total_bytes.
lengthqueryintegerno4194304Bytes per page, 1..4194304.

Responses

StatusBodyDescription
200SpanText (application/json)OK
304noneNot modified: If-None-Match named this page's ETag (answered before the document is read).
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).
404Problem (application/problem+json)No filing with this accession (code not_found); the filing's form is not covered by this route's dataset (code not_covered, with members form_type, dataset and routes: the routes that cover it); for a text route, no such item or section in the parsed filing (code not_found).
422Problem (application/problem+json)The stored document is larger than this server converts to text (code document_too_large, with members document_bytes, limit and document: the document's URL, whose span_start..span_end Range holds the filed bytes of the passage). Nothing was read.
503Problem (application/problem+json)Database unavailable (code db_unavailable); or the document's conversion to text did not finish within the request's time (code conversion_timeout, with Retry-After): it goes on, and the same request after the delay is answered from the converted text.
504Problem (application/problem+json)The request's time ran out (code timeout), e.g. while it waited for the server's conversion budget; nothing was converted for it.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a SpanText object.

FieldTypeRequiredDescription
accessionstringno
docmodel_versionstring | nullno
documentobject | nullno
extractionExtractionno
next_offsetinteger | nullno
sectionstringno
served_model_versionstringno
textstring | nullno
text_bytesinteger | nullno
text_offsetinteger | nullno
text_reasonstring | nullnoOne of: model_changed, bytes_unavailable, null.
text_statusstringnoOne of: current, from_version, reparse_pending, no_text, parse_pending.
text_total_bytesinteger | nullno
text_truncatedbooleanno

Example request

Shell
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
  'https://api.secblast.com/v3/filings/0001829126-26-010431/sections/10k.1a/text'

Open this route in the console

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

Previous: GET /v3/filings/{accession}/sections · Next: GET /v3/sections

Markdown version: /docs/reference/get-filings-accession-sections-section-text.md