---
title: "Create usage charge"
method: POST
path: "/subscriptions/{subscriptionId}/usages/{usageId}/charges"
tags: ["Subscriptions"]
---

# Create usage charge

`POST /subscriptions/{subscriptionId}/usages/{usageId}/charges`

Creates a one-off charge (quantity 1) against a usage product the account is subscribed to.
The charge is processed asynchronously.
            
Important considerations:
* The usage product must already be subscribed on the account's usage subscription
* The price must exist on the usage product and be active
* Charges are rejected while the usage subscription is overdue (past due, unpaid, canceled, or incomplete-expired)
* The caller must be authorized for usage billing on the product

## Path parameters

- `subscriptionId` string, required
- `usageId` string, uuid, required

## Request body

- CreateUsageChargeRequest
  - `priceId` string, uuid, nullable — The price to charge for this usage product.
  - `matterId` string, uuid, nullable — The matter id associated with the usage charge.
  - `description` string, nullable — The description associated with the usage charge.
  - `metadata` object, nullable — Optional metadata associated with the usage charge.

## Response `202`

When request is accepted. Returns a 'Link' object to the created charge.

- Link
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable

## Other responses

- `400` — When the request is missing or invalid, the usage is not subscribed, the price is inactive, or the account is overdue.
- `403` — When the user is not authorized for usage billing on the product.
- `404` — When the usage subscription, usage product, or price does not exist.

---

[API](https://skmtc.net/smokeball/apis/api.md) · [All operations](https://skmtc.net/smokeball/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smokeball/api/versions/197984da9b42/schema)