Month Out Of Range

month-out-of-range · 400

The month asked for is outside the two months the usage breakdown covers, so the API returned none.

The breakdown covers this month and last month, in UTC, and earliestMonth and latestMonth name them. Without month, it shows this month.

Besides the members every error carries, this type adds earliestMonth and latestMonth.

Common causes

  • month names a month older than last month.
  • month names a month still to come.

How to fix the call

  • Ask for a month from earliestMonth to latestMonth.
  • For an older month, read its invoice: ghaym cloud billing invoices list, then ghaym cloud billing invoices get <id>.

Example response

json
{
  "type": "month-out-of-range",
  "title": "Month Out Of Range",
  "detail": "The breakdown covers 2026-06 to 2026-07 only. Older months are the payer's issued invoices.",
  "earliestMonth": "2026-06",
  "latestMonth": "2026-07",
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/billing/usage/breakdown",
  "method": "GET",
  "instance": "GET /v1/billing/usage/breakdown",
  "status": 400,
  "docs": "https://ghaym.me/docs/errors/month-out-of-range"
}