Skip to content

Reporting usage

POST /api/v1.0/subscriptions/{subscriptionId}/actions/charge
     ?dimensionId=transaction_tier_1
     &quantity=5
     &effectiveStartTime=2026-09-07T10:00:00Z
x-api-key: <key>
  • quantity: whole number, at least 1.
  • effectiveStartTime: optional, ISO 8601 with a Z or offset. Defaults to now. Must not be in the future or older than 24 hours. Always send it explicitly and store the value you sent: it is your idempotency key. If you omit it, the accepted response carries a Warning explaining why that is unsafe.

Microsoft accepts one usage event per subscription, dimension and hour of effectiveStartTime. WeTransact applies the same rule before calling Microsoft, but only against reports Microsoft has accepted, so a failed attempt never blocks its own retry.