curl "https://reygrid.com/api/v1/usage?days=7" \
  -H "Authorization: Bearer $REYGRID_API_KEY"

from reygrid import ReyGrid

client = ReyGrid(api_key="YOUR_API_KEY")

report = client.get_usage_report(days=7)
print(report.balance.credits, report.totals.requests)
for day in report.daily:
    print(day.date, day.requests, day.credits)

import { ReyGrid } from "reygrid";

const client = new ReyGrid({ apiKey: "YOUR_API_KEY" });

const report = await client.getUsageReport({ days: 7 });
console.log(report.balance.credits, report.totals.requests);
for (const day of report.daily) console.log(day.date, day.requests, day.credits);

{
  "success": true,
  "balance": {
    "credits": 212.55,
    "plan": "Pro",
    "renewsAt": "2026-11-01T00:00:00.000Z"
  },
  "period": {
    "days": 7,
    "from": "2026-09-29T00:00:00.000Z",
    "to": "2026-10-05T10:21:34.120Z"
  },
  "totals": {
    "requests": 28,
    "failed": 3,
    "credits": 15.75
  },
  "daily": [
    {
      "date": "2026-09-29T00:00:00.000Z",
      "requests": 2,
      "failed": 0,
      "credits": 1
    },
    {
      "date": "2026-09-30T00:00:00.000Z",
      "requests": 0,
      "failed": 0,
      "credits": 0
    },
    {
      "date": "2026-10-01T00:00:00.000Z",
      "requests": 5,
      "failed": 1,
      "credits": 2.5
    },
    {
      "date": "2026-10-02T00:00:00.000Z",
      "requests": 9,
      "failed": 1,
      "credits": 4.75
    },
    {
      "date": "2026-10-03T00:00:00.000Z",
      "requests": 4,
      "failed": 0,
      "credits": 2.5
    },
    {
      "date": "2026-10-04T00:00:00.000Z",
      "requests": 3,
      "failed": 1,
      "credits": 1.5
    },
    {
      "date": "2026-10-05T00:00:00.000Z",
      "requests": 5,
      "failed": 0,
      "credits": 3.5
    }
  ],
  "agents": [
    {
      "id": {
        "AgentId": null
      },
      "name": "Support",
      "requests": 21,
      "credits": 11.2
    },
    {
      "id": "7MDhZpEPGy",
      "name": null,
      "requests": 7,
      "credits": 4.55
    }
  ]
}

{
  "success": false,
  "error": {
    "code": "INVALID_BODY",
    "message": "Invalid body",
    "list": {
      "title": [
        "Title too short"
      ]
    }
  }
}

{
  "error": "Unauthorized",
  "code": "AUTH_REQUIRED"
}