---
title: "Delete StatementDefinition"
method: DELETE
path: "/organizations/{orgId}/statementdefinitions/{id}"
tags: ["StatementDefinition"]
---

# Delete StatementDefinition

`DELETE /organizations/{orgId}/statementdefinitions/{id}`

Delete a StatementDefinition with the given UUID.

This endpoint deletes a specific StatementDefinition within a specified Organization, using the StatementDefinition UUID.

## Path parameters

- `orgId` string, required
- `id` string, required

## Response `200`

Returns the deleted StatementDefinition

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

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