---
title: "Get consumed units for a customer"
method: GET
path: "/v1/meters/{id}/consumed"
tags: ["Meters"]
---

# Get consumed units for a customer

`GET /v1/meters/{id}/consumed`

## Request

- Base URL: `https://api.creem.io`
- URL: `https://api.creem.io/v1/meters/{id}/consumed`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/creem/apis/creem-api/docs/v1/meters/:id/consumed/get.ts> (a function with typed inputs; its response is checked against the schema)

How many units a customer has consumed through this meter in a billing period, alongside the period's boundaries. Without `at`, this is an O(1) read of the current period's projection — the number billing uses. With `at`, the units are replayed from the raw events as of that instant, within the billing period containing it, which is the right call for reconstructing what a customer had consumed at a past moment (an invoice date, a support question).

## Path parameters

- `id` string, required

## Query parameters

- `customer_id` string, required
- `at` string

## Response `200`

Consumed units for the period

- MeterConsumedUnitsApiResponseDto
  - `meter_id` string, required: Meter ID
  - `customer_id` string, required: Customer ID
  - `units` string, required: Consumed units for the period, as a string for BigInt safety
  - `period_start` string, required: Start of the billing period (inclusive, ISO 8601)
  - `period_end` string, required: End of the billing period (exclusive, ISO 8601)
  - `updated_at` string, nullable, required: When the projection was last advanced. Null when no usage has been folded into this period yet, and always null for an `at=` reply (which is replayed from raw events rather than read from the projection).
  - `as_of` string: The point in time the units were replayed as of. Present only when `at=` was supplied.

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found - Resource does not exist

## Changes

- **2026-09-15** `071301350724`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/creem/apis/creem-api/changes/v1/meters/:id/consumed/get.md)

---

[API](https://skmtc.dev/creem/apis/creem-api.md) - [All operations](https://skmtc.dev/creem/apis/creem-api/llms.txt) - [OpenAPI document](https://skmtc.dev/creem/apis/creem-api/revisions/3f39a8f266c3?raw)