# 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](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 |
|---|---|---|---|---|---|
| `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](https://www.secblast.com/docs/reference/schemas#schema-sectionsearchlist) (`application/json`) | OK |
| `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). |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `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 [SectionSearchList](https://www.secblast.com/docs/reference/schemas#schema-sectionsearchlist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `as_of` | string \| null | no |   |
| `data` | array of object | no |   |
| `data[].filing` | [FilingRef](https://www.secblast.com/docs/reference/schemas#schema-filingref) | no |   |
| `data[].form` | string | no |   |
| `data[].links` | object | no |   |
| `data[].scope_kind` | string | no |   |
| `data[].section` | [Section](https://www.secblast.com/docs/reference/schemas#schema-section) | no |   |
| `form` | string | no |   |
| `has_more` | boolean | no |   |
| `next_cursor` | string \| null | no |   |
| `section` | string | no |   |
| `snapshot` | [Snapshot](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | no |   |

## Example request

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

[Open this route in the console](https://www.secblast.com/console#get-v3-sections)

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

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