BILLING_USAGE_READ_FAILED

Cause

The metering read failed. There is deliberately no zero-default: a zero that means 'we could not read' is indistinguishable from a genuine zero, and that silently under-bills.

How to fix it

Retry with backoff. The monthly run redrives automatically; nothing was billed.

Example response

{
  "error_code": "BILLING_USAGE_READ_FAILED",
  "error_type": "upstream",
  "error_message": "Usage could not be read for the period.",
  "hint": "Retry with backoff. The monthly run redrives automatically; nothing was billed.",
  "docs_url": "https://docs.billerapi.com/errors/BILLING_USAGE_READ_FAILED",
  "request_id": "d94f5e2a-8c3b-4f1e-9a7d-6b2c1e0f8a34"
}

Related

• Error handling — the error envelope shape and how to parse it
• Error code reference — every stable error code