---
title: "Record usage for a subscription"
method: POST
path: "/1.0/kb/usages"
tags: ["Usage"]
---

# Record usage for a subscription

`POST /1.0/kb/usages`

## Headers

- `X-Killbill-CreatedBy` string, required
- `X-Killbill-Reason` string
- `X-Killbill-Comment` string

## Request body

- SubscriptionUsageRecord
  - `subscriptionId` string, uuid, required
  - `trackingId` string
  - `unitUsageRecords` UnitUsageRecord[], required
    - `unitType` string
    - `usageRecords` UsageRecord[]
      - `recordDate` string, date
      - `amount` integer

## Response `200`

Successfully recorded usage data change

## Other responses

- `400` — Invalid subscription (e.g. inactive)

---

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