# 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](https://www.secblast.com/docs/authentication).

**Group:** [Sections of 10-K, 10-Q and 20-F](https://www.secblast.com/docs/reference#sections-of-10-k-10-q-and-20-f)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `accession` | path | string | yes |   | Accession number, with dashes (0001829126-26-010431) or without (18 digits). |
| `section` | path | string | yes |   | A section key, e.g. 10k.1a, 10q.p1i2, 20f.3d. |
| `offset` | query | integer | no | `0` | Byte offset in the section's text, 0..text_total_bytes. |
| `length` | query | integer | no | `4194304` | Bytes per page, 1..4194304. |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [SpanText](https://www.secblast.com/docs/reference/schemas#schema-spantext) (`application/json`) | OK |
| `304` | none | Not modified: If-None-Match named this page's ETag (answered before the document is read). |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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). |
| `422` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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. |
| `504` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [SpanText](https://www.secblast.com/docs/reference/schemas#schema-spantext) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `accession` | string | no |   |
| `docmodel_version` | string \| null | no |   |
| `document` | object \| null | no |   |
| `extraction` | [Extraction](https://www.secblast.com/docs/reference/schemas#schema-extraction) | no |   |
| `next_offset` | integer \| null | no |   |
| `section` | string | no |   |
| `served_model_version` | string | no |   |
| `text` | string \| null | no |   |
| `text_bytes` | integer \| null | no |   |
| `text_offset` | integer \| null | no |   |
| `text_reason` | string \| null | no | One of: `model_changed`, `bytes_unavailable`, `null`. |
| `text_status` | string | no | One of: `current`, `from_version`, `reparse_pending`, `no_text`, `parse_pending`. |
| `text_total_bytes` | integer \| null | no |   |
| `text_truncated` | boolean | no |   |

## Example request

```bash
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](https://www.secblast.com/console#get-v3-filings-accession-sections-section-text)

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

Previous: [`GET /v3/filings/{accession}/sections`](https://www.secblast.com/docs/reference/get-filings-accession-sections) · Next: [`GET /v3/sections`](https://www.secblast.com/docs/reference/get-sections)
