Skip to main content
POST
/
api
/
v1
/
usage
Track Usage Event
curl --request POST \
  --url https://api.example.com/api/v1/usage \
  --header 'Content-Type: application/json' \
  --data '
{
  "meter_id": "<string>",
  "customer_id": "<string>",
  "quantity": 123,
  "timestamp": "<string>",
  "idempotency_key": "<string>"
}
'
For server-to-server integration, prefer the SDK endpoint which uses API key auth.
​
meter_id
string
required
UUID of the meter
​
customer_id
string
required
UUID of the customer
​
quantity
number
required
Usage quantity (> 0)
​
timestamp
string
ISO 8601 event time (defaults to now)
​
idempotency_key
string
Deduplication key