Skip to main content
POST
Record usage

Overview

Record usage for a metered subscription. The idempotency_key is required so a retried report cannot bill a customer twice. Derive it from the thing being reported, such as the subscription and the window, rather than generating a random one.

Authorizations

Api-Key
string
header
required

Your Reclack API key. The prefix decides the environment: rk_sandbox_ for test chains, rk_live_ for production.

Path Parameters

subscriptionId
string
required

The subscription being metered.

Body

application/json
quantity
integer
required

Whole units of whatever you meter.

Example:

48210

idempotency_key
string
required

Makes a retry safe.

Example:

"sub_4Kd9:2026-10-18T22:00"

recorded_at
string<date-time>

When the usage happened. Defaults to now.

metadata
object

Your own context, such as the meter name.

Response

Created

data
object