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

## Changes

- **2025-08-29** `0f92c877619f` — 3 warning, 6 info
  - removed the optional property `data/items/allOf[subschema #2]/dimensions/items/dimensionAttributes` from the response with the `200` status
  - removed the optional property `data/items/allOf[subschema #2]/dimensions/items/dimensionName` from the response with the `200` status
  - added the new `CUSTOM_SQL` enum value to the `data/items/allOf[subschema #2]/measures/items/aggregations/items/` response property for the response status `200`
  - added the optional property `data/items/allOf[subschema #2]/dimensions/items/attributes` to the response with the `200` status
  - …5 more
- **2025-08-01** `9f9e5f3dbde7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/statementdefinitions/get.md)

---

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