curl "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/usage?startDate=2026-04-01T00:00:00Z&endDate=2026-05-01T00:00:00Z" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
"startDate": "2026-04-01T00:00:00Z",
"endDate": "2026-05-01T00:00:00Z",
"currency": "usd",
"totalSpendCents": 8500,
"totalTopupCents": 20000,
"totalRefundCents": 0,
"totalAdjustmentCents": 1500,
"byType": {
"usage": -8500,
"topup": 20000,
"refund": 0,
"adjustment": 1500
}
}
Billing
Get usage summary
Aggregates wallet transactions across a date range and returns total spend, total top-ups, total refunds, net adjustments, and a per-type breakdown.
GET
/
workspaces
/
{workspaceId}
/
billing
/
usage
curl "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/usage?startDate=2026-04-01T00:00:00Z&endDate=2026-05-01T00:00:00Z" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
"startDate": "2026-04-01T00:00:00Z",
"endDate": "2026-05-01T00:00:00Z",
"currency": "usd",
"totalSpendCents": 8500,
"totalTopupCents": 20000,
"totalRefundCents": 0,
"totalAdjustmentCents": 1500,
"byType": {
"usage": -8500,
"topup": 20000,
"refund": 0,
"adjustment": 1500
}
}
This endpoint is for the VIP plan only. Other plans get a
403. See Plan access.string
required
Workspace UUID
string
Inclusive ISO 8601 lower bound on
created_at.string
Exclusive ISO 8601 upper bound on
created_at.curl "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/usage?startDate=2026-04-01T00:00:00Z&endDate=2026-05-01T00:00:00Z" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
"startDate": "2026-04-01T00:00:00Z",
"endDate": "2026-05-01T00:00:00Z",
"currency": "usd",
"totalSpendCents": 8500,
"totalTopupCents": 20000,
"totalRefundCents": 0,
"totalAdjustmentCents": 1500,
"byType": {
"usage": -8500,
"topup": 20000,
"refund": 0,
"adjustment": 1500
}
}
Was this page helpful?