---
title: "Retrieve usage for a subscription"
method: GET
path: "/1.0/kb/usages/{subscriptionId}"
tags: ["Usage"]
---

# Retrieve usage for a subscription

`GET /1.0/kb/usages/{subscriptionId}`

## Path parameters

- `subscriptionId` string, uuid, required

## Query parameters

- `startDate` string, date
- `endDate` string, date

## Response `200`

successful operation

- RolledUpUsage
  - `subscriptionId` string, uuid
  - `startDate` string, date
  - `endDate` string, date
  - `rolledUpUnits` RolledUpUnit[]
    - `unitType` string
    - `amount` integer

## Other responses

- `400` — Missing start date or end date

---

[API](https://skmtc.net/killbill/apis/kill-bill.md) · [All operations](https://skmtc.net/killbill/apis/kill-bill/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/killbill/kill-bill/revisions/0fb95d23caf5/schema)