---
title: "List summary statement runs"
method: GET
path: "/object-query/summarystatementruns"
tags: ["Object Queries"]
---

# List summary statement runs

`GET /object-query/summarystatementruns`

Lists statement runs. You can use the query parameters to filter, expand, and sort the returned results.

## Query parameters

- `pageSize` integer
- `cursor` string
- `sort[]` string[]
- `expand[]` string[]
- `filter[]` string[]
- `fields[]` string[]
- `includeNullFields` boolean

## Headers

- `Idempotency-Key` string
- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- ExpandedSummaryStatementRun
  - `accountId` string — The unique identifier for the statement account.
  - `autoEmailEnabled` string — Indicates whether automatic emails are enabled.
  - `batchName` string — The name of the batch used to filter accounts, for example, Batch1.
  - `billCycleDay` string, nullable — The bill cycle day for filtering accounts, represented as a number, for example '01' to '31'.
  - `createdDate` string, dateTime — The date and time when the summary statement run was created.
  - `updatedDate` string, dateTime — The date and time when the summary statement run was last updated.
  - `createdById` string — The user ID of the person who created the summary statement run.
  - `updatedById` string — The user ID of the person who last updated the summary statement run.
  - `dateRangeType` 'Custom' | 'PreviousOneCalendarMonth' | 'PreviousThreeCalendarMonth' — The type of date range used for the statement.
  - `deleted` string — Indicates whether the statement has been deleted.
  - `description` string — A description of the summary statement run.
  - `endDate` string, date — The end date of the statement in the format YYYY-MM-DD.
  - `id` string — The unique identifier of the statement.
  - `numberOfAccounts` string — The number of accounts being processed in the summary statement run.
  - `runType` 'AdHoc' | 'Scheduled' — The type of summary statement run.
  - `startDate` string, date — The start date of the statement in the format YYYY-MM-DD.
  - `statementRunNumber` string — The unique number assigned to this statement run.
  - `status` 'Pending' | 'Processing' | 'GenerationCompleted' | 'Completed' | 'Error' | 'Terminated' — The current status of the statement, with possible values: - Pending - Processing - GenerationCompleted - Completed (indicates PDF generation is completed and emails are triggered if AutoEmailEnabled) - Error - Terminated For AutoEmailEnabled, the possible values are Pending, Processing, GenerationCompleted, Completed, Error For AutoEmailDisabled, the possible values are Pending, Processing, Completed
  - `targetAccountCategory` 'SingleAccount' | 'AllAccounts' | 'AccountsWithOpenInvoices' | 'AccountsWithOpenBalances' | 'AccountsWithoutInvoices' | 'AccountsWithoutInvoicesAndOpenBalances' — The method used to filter accounts.
  - `errorCategory` string — The category of error when the operation fails.
  - `errorMessage` string — The specific error message when the operation fails.
  - `success` boolean — Indicates whether the call succeeded.
  - `statementDate` string, date — The date of the statement in the format YYYY-MM-DD.
  - `statementNumber` string — The unique number assigned to the statement.
  - `statementRunId` string — ID of the statement run.
  - `emailStatus` string — The email status of the statement.

## Other responses

- `500` — Internal server error
- `4XX` — Invalid input

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)