# GET /v3/companies/{cik}/statements

A company's statement as presented in its latest periodic report (10-K, 10-Q, 10-KT, 10-QT, 20-F, 40-F and amendments) SEC had accepted by as_of that has one: of one kind (with its parentheticals), of one menu category (notes, details, ...) or one role URI; limit \> 1 gives the previous reports' too, newest first. Each report's statements are paged as on /v3/filings/{accession}/statements (has_more; links.next continues there). A category without kind or role_uri names one report (limit 1): its roles are paged here, with has_more and next_cursor. Deleted (SEC-withdrawn) reports are skipped (the previous report is served) and the ones the answer would have read are named in excluded.

**API key:** required. See [Authentication](https://www.secblast.com/docs/authentication).

**Group:** [Financial data (XBRL)](https://www.secblast.com/docs/reference#financial-data-xbrl)

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik` | path | string | yes |   | The company's CIK (the filing's primary filer), padded or unpadded. |
| `kind` | query | string | no |   | BS, IS, CF, EQ, CI, CP or UN. Required unless category or role_uri is given. One of: `BS`, `IS`, `CF`, `EQ`, `CI`, `CP`, `UN`. |
| `category` | query | string | no |   | The role's menu category as SEC's FilingSummary states it, any letter case: Cover, Statements, Notes, Policies, Tables, Details, Other or Uncategorized (notes, policies, tables and details are served like statements). |
| `role_uri` | query | string | no |   | Only the role with this URI (roles\[\].role_uri), e.g. a company's own detail role. |
| `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) or YYYY-MM-DD (the whole UTC day). Against each incarnation's filing acceptance time. |
| `limit` | query | integer | no | `1` | Reports, 1..8 (1 with a category alone). |
| `cursor` | query | string | no |   | next_cursor of the previous page (a category alone; same filters). |

## Responses

| Status | Body | Description |
|---|---|---|
| `200` | [XbrlCompanyStatements](https://www.secblast.com/docs/reference/schemas#schema-xbrlcompanystatements) (`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 [XbrlCompanyStatements](https://www.secblast.com/docs/reference/schemas#schema-xbrlcompanystatements) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `as_of` | string \| null | yes |   |
| `category` | string \| null | yes |   |
| `cik` | string | yes |   |
| `data` | array of object | yes |   |
| `data[].accession` | string | no |   |
| `data[].filing` | object | no | With links.next: the filing route's next page of this report. |
| `data[].has_more` | boolean | no |   |
| `data[].statements` | array of [XbrlStatement](https://www.secblast.com/docs/reference/schemas#schema-xbrlstatement) | no |   |
| `excluded` | [Excluded](https://www.secblast.com/docs/reference/schemas#schema-excluded) | yes |   |
| `excluded_total` | integer | yes |   |
| `has_more` | boolean | yes | A category alone: the report's next roles (next_cursor). |
| `kind` | string \| null | yes |   |
| `next_cursor` | string \| null | yes |   |
| `role_uri` | string \| null | yes |   |

## Example request

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

The entity in this example is only an illustration.

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

## More in Financial data (XBRL)

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