---
title: "Get a breakdown of your credit consumption for flat-rated products"
method: GET
path: "/v1/consumption"
tags: ["Consumption"]
---

# Get a breakdown of your credit consumption for flat-rated products

`GET /v1/consumption`

Returns a breakdown of your credit consumption for flat-rated products, grouped by calendar day (per UTC) and then by the type of consumption and relevant dimensions. This data refreshes every three hours to reflect recent credit usage.

## Query parameters

- `consumedFrom` string, date, required
- `consumedBefore` string, date, required

## Response `200`

Successful

- Consumption
  - `results` ConsumptionBreakdown[] — An array of date periods, each containing the consumption for that period
    - `consumedBefore` string, date-time — Calendar date before which results are included (UTC) (exclusive)
    - `consumedFrom` string, date-time — First calendar date included in results (UTC) (inclusive)
    - `consumption` ConsumptionEntry[] — All consumption entries for the given date range
      - `consumptionType` string — The type of credit consumption
      - `credits` number, double — The number of credits consumed for this combination of type and dimensions
      - `dimensions` ConsumptionDimensions
        - `environment` string — For orchestration and transformation consumption, the name of the environment in which the pipeline ran
        - `installationId` string — For ETL consumption, the identifier of the installation
        - `pipelineId` string — For data loading consumption, the identifier of the pipeline
        - `pipelineName` string — For orchestration, transformation and streaming consumption, the full path of the pipeline (e.g. projects/my-project/pipelines/daily-load.orch.yaml). Values exceeding 255 characters may be middle-truncated (e.g. projects/very/deep/.../my_pipeline.orch.yaml)
        - `projectId` string — For orchestration, transformation and streaming consumption, the identifier of the containing project (returned alongside `pipelineName`)
        - `userEmail` string — For monthly active DPC users consumption, the email address of the Matillion user

## Other responses

- `400` — Wrong request parameters used
- `403` — Unauthorized
- `500` — Unexpected error occurred

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/revisions/6239825f68eb/schema)