---
title: "Get the result of an accepted filing items request"
method: GET
path: "/filings/items/requests/{request_id}"
tags: ["SEC Filings"]
---

# Get the result of an accepted filing items request

`GET /filings/items/requests/{request_id}`

## Request

- Base URL: `https://api.financialdatasets.ai`
- URL: `https://api.financialdatasets.ai/filings/items/requests/{request_id}`
- Auth: API key in header `X-API-KEY`

Poll the result of a filing items request that returned 202 Accepted. While the filing is being prepared this returns a processing status. When ready, it returns the same payload as GET /filings/items; you are billed once, on the first response that contains data. If the filing could not be prepared, it returns a failed status and you can re-request GET /filings/items with your original parameters.

## Path parameters

- `request_id` string, uuid, required

## Response `200`

The request's current result: a processing status, the filing items payload (ready), or a failed status.

- union
  - FilingItemsRequestProcessing
    - `status` 'processing': The filing is still being prepared. Poll again after the Retry-After duration.
    - `request_id` string, uuid
    - `accession_number` string
    - `estimated_ready_at` string, date-time: When the filing is expected to be ready.
  - FilingItemsResponse
    - `resource` string: The resource type identifier.
    - `ticker` string: The ticker symbol of the company.
    - `cik` string: The Central Index Key (CIK) of the company.
    - `filing_type` string: The type of filing.
    - `accession_number` string: The accession number of the filing.
    - `year` integer: The year of the filing.
    - `quarter` integer: The quarter of the filing.
    - `items` FilingItem[]
      - `number` string: The item number.
      - `name` string: The item name.
      - `text` string: The item text.
      - `exhibits` Exhibit[]: An array of exhibits linked to this item. Only present for 8-K filings when exhibits exist.
        - `number` string: The exhibit number (e.g., '99.1').
        - `description` string: The description of the exhibit.
        - `url` string, uri: The URL to the exhibit document on the SEC website.
        - `text` string: The raw text content of the exhibit. Only included when 'include_exhibits' parameter is set to true.
  - FilingItemsRequestFailed
    - `status` 'failed': The filing could not be prepared. Re-request GET /filings/items with your original parameters to try again.
    - `request_id` string, uuid
    - `accession_number` string
    - `message` string: Human-readable description of what to do next.

## Other responses

- `401`: Unauthorized
- `404`: The specified resource was not found

## Changes

- **2026-11-03** `5872e134b56c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/changes/filings/items/requests/:request_id/get.md)

---

[API](https://skmtc.dev/financialdatasets/apis/financial-datasets-api.md) - [All operations](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/llms.txt) - [OpenAPI document](https://skmtc.dev/financialdatasets/apis/financial-datasets-api/revisions/42ba45d24472?raw)