API reference · Workspace

List balance history

GEThttps://goblins-call-api.onrender.com/v1/users/:id/passbook

Returns the workspace’s ledger, newest first: every call that was billed and every credit added.

Needs a workspace API key.

Path parameters

idstringRequired

Your workspace ID.

Query parameters

limitintegerOptionalup to 500; default 50

How many entries to return.

Response

passbook[].typeenumcredit · debit

Whether the entry added to the balance or took from it.

passbook[].reasonstring

Why: call_usage for a billed call, signup_credit, plan_credit or topup for a payment, or an adjustment.

Errors

404

That is not your workspace.

Every request can also answer 401, 429 and 500: see Errors.

curl "https://goblins-call-api.onrender.com/v1/users/usr_8c1d2e3f4a5b/passbook?limit=20" \
  -H "Authorization: Bearer $CRACKLE_API_KEY"

Response · 200 OK

{
  "passbook": [
    {
      "id": "9031",
      "userId": "usr_8c1d2e3f4a5b",
      "type": "debit",
      "amount": 0.2147,
      "balanceBefore": 42.4,
      "balanceAfter": 42.1853,
      "reason": "call_usage",
      "description": "Call usage: 184s @ $0.07/min",
      "callId": "8f1c2c1e-7b1a-4e0a-9c55-2f6f0d3b1a90",
      "agentId": "ua_3f9a1c2b",
      "durationSeconds": 184,
      "ratePerMinute": 0.07,
      "createdAt": "2026-10-11T05:59:19.000Z"
    }
  ],
  "user": { "id": "usr_8c1d2e3f4a5b", "balance": 42.1853, … }
}