---
title: "Download Statements"
method: POST
path: "/plug/statements/downloads"
tags: ["Statements"]
---

# Download Statements

`POST /plug/statements/downloads`

Downloading a CSV file with high-level summary information for accounts, statements, and associated metadata is a 2 step process. The first step (this one) prepares the download and provides a URL in the response body that can be used for downloading the CSV file. [The next step](https://docs.arcadia.com/reference/stream-download) is to download the file using a GET request with the response body URL. The maximum number of statement IDs is 500. If you need to download more than 500 accounts, you will need to make multiple requests. Alternatively, instead of statementIds you can provide search/globalSearch (the same filters as [List Statements](https://docs.arcadia.com/reference/list-statements)) to download every statement matching the search. The format of the generated CSV is separate from and will not exactly match the JSON you receive from the API endpoint.

This endpoint supports [Sandbox Mode](https://docs.arcadia.com/docs/sandbox-testing).

## Headers

- `Arcadia-Version` string, required

## Request body

- PublicDownloadStatementAccountsRequest
  - `downloadMethod` 'EMAIL' | 'IN_BROWSER' — The method used to download the data.
  - `endDate` string, date-time, required — The end date of the billing period.
  - `globalSearch` string — Global search across statement fields.
  - `search` string — RSQL filter; same fields as list statements.
  - `startDate` string, date-time, required — The date indicating the start of a billing cycle or service period.
  - `statementIds` string[] — An array of unique identifiers for statements.

## Response `202`

Accepted

- PublicDownloadRequestResource
  - `createdAt` string, date-time, required — A timestamp indicating when the entity was created.
  - `downloadMethod` 'EMAIL' | 'IN_BROWSER', required — Method used for downloading data.
  - `id` string, required — A unique identifier for the entity.
  - `status` 'SUCCESS' | 'PREPARING' | 'FAILURE' | 'NO_CONTENT', required — Status of the resource.
  - `token` string, required — We require this token to be provided when you want to access the requested download file. If you made the request via an API call, this token can be found in our response to you. If you made the request via the Dashboard, this token already be included in the email we would send you.

---

[API](https://skmtc.net/arcadia/apis/plug-api.md) · [All operations](https://skmtc.net/arcadia/apis/plug-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arcadia/plug-api/versions/d00587742116/schema)