---
title: "Download Meter Intervals by Site"
method: POST
path: "/plug/sites/downloads/intervals"
tags: ["Sites"]
---

# Download Meter Intervals by Site

`POST /plug/sites/downloads/intervals`

Downloading a CSV file with meter intervals 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 site IDs is 500. If you need to download more than 500 sites, you will need to make multiple requests, or alternatively provide search/globalSearch (the same filters as [List Sites](https://docs.arcadia.com/reference/list-sites)) to download intervals for every site 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

- PublicDownloadIntervalsRequest
  - `downloadMethod` 'EMAIL' | 'IN_BROWSER' — The method used to download the data.
  - `endAt` string, date-time, required — The end date of the billing period.
  - `globalSearch` string — Global search across meter fields, used together with select-all by search.
  - `ids` string[] — An array of unique identifiers for multiple meters/sites.
  - `intervalFormat` 'RAW' | 'NORMALIZED' — The format in which output data is provided. Default : RAW
  - `intervalTimeZone` 'UTC' | 'METER' — The timezone for the intervals. Default : METER
  - `search` string — RSQL filter selecting the meters to download intervals for (select-all by search). An empty value means no filter (all meters).
  - `startAt` string, date-time, required — The date indicating the start of a billing cycle or service period.

## 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)