---
title: "List StatementDefinitions"
method: GET
path: "/organizations/{orgId}/statementdefinitions"
tags: ["StatementDefinition"]
---

# List StatementDefinitions

`GET /organizations/{orgId}/statementdefinitions`

Retrieve a list of StatementDefinitions.

This endpoint retrieves a list of all the StatementDefinitions within a specified Organization. The list can be paginated for easier management.

## Path parameters

- `orgId` string, required

## Query parameters

- `pageSize` integer
- `nextToken` string

## Response `200`

Returns the list of requested StatementDefinitions

- PaginatedStatementDefinitionResponseData
  - `data` StatementDefinitionResponse[]
    - `id` string, required — The unique identifier (UUID) of the StatementDefinition.
    - `version` integer — The version number. Default value when newly created is one.
    - `name` string — Descriptive name for the StatementDefinition providing context and information.
    - `aggregationFrequency` 'DAY' | 'WEEK' | 'MONTH' | 'QUARTER' | 'YEAR' | 'WHOLE_PERIOD' — This specifies how often the data should be aggregated.
    - `includePricePerUnit` boolean — A Boolean indicating whether to include the price per unit in the Statement. * TRUE - includes the price per unit. * FALSE - excludes the price per unit.
    - `dimensions` Dimension[] — An array of objects, each representing a Dimension data field from a Meter *(for Meters that have Dimensions setup)*.
      - `meterId` string — The unique identifier (UUID) of the Meter containing this Dimension.
      - `name` string, required — The name of the Dimension to target in the Meter.
      - `attributes` string[] — The Dimension attribute to target.
      - `filter` string[], required — The value of a Dimension to use as a filter. Use "*" as a wildcard to filter on all Dimension values.
    - `measures` Measure[] — An array of objects, each representing a Measure data field from a Meter.
      - `meterId` string — The unique identifier (UUID) of the Meter containing this Measure.
      - `name` string — The name of a Measure data field *(or blank to indicate a wildcard, i.e. all fields)*. Default value is blank.
      - `aggregations` Aggregation[] — A list of Aggregations to apply to the Measure.
    - `generateSlimStatements` boolean
    - `dtCreated` string, date-time — The date and time *(in ISO-8601 format)* when the StatementDefinition was created.
    - `dtLastModified` string, date-time — The date and time *(in ISO-8601 format)* when the StatementDefinition was last modified.
    - `createdBy` string — The unique identifier (UUID) of the user who created this StatementDefinition.
    - `lastModifiedBy` string — The unique identifier (UUID) of the user who last modified this StatementDefinition.
  - `nextToken` string

## Other responses

- `4XX` — Error message
- `5XX` — Error message

---

[API](https://skmtc.net/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.net/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)