{
  "object": "doc",
  "title": "Account and usage: GET /api/v1/account, /usage",
  "description": "Credit balance, key details and the credit ledger.",
  "section": "API reference",
  "url": "https://cart-route.com/docs/api/account",
  "updated": "2026-09-23",
  "prev": "https://cart-route.com/docs/api/reference",
  "next": "https://cart-route.com/docs/api/accounts",
  "text": "`GET /api/v1/account` returns the caller's credit balance, verification state and key details; `GET /api/v1/usage` returns the credit ledger. Both need a key and cost nothing, so an agent can check its budget before a batch of searches.\n\nGET https://cart-route.com/api/v1/account\n\nGET https://cart-route.com/api/v1/usage?limit=50\n\n## What does /account return?\n\n```\n{\n  \"object\": \"account\",\n  \"request_id\": \"req_7f3k2m9x1q0a4b8c\",\n  \"id\": \"usr_4k2m9x1q0a4b8c7f3k\",\n  \"email\": \"sam@example.com\",\n  \"name\": \"Sam Rivera\",\n  \"email_verified\": false,\n  \"credits_remaining\": 96,\n  \"low_balance\": false,\n  \"verification_bonus_available\": 100,\n  \"api_key\": {\n    \"id\": \"key_9x1q0a4b8c7f3k2m\",\n    \"name\": \"production agent\",\n    \"scopes\": [\n      \"search:read\",\n      \"catalog:read\",\n      \"coupons:read\"\n    ]\n  },\n  \"dashboard\": \"https://cart-route.com/dashboard\"\n}\n```\n\n`low_balance` is true below 20 credits. `verification_bonus_available` is the number of credits the account will receive when its email is confirmed (0 once granted).\n\n## What does /usage return?\n\n```\n{\n  \"object\": \"usage\",\n  \"credits_remaining\": 96,\n  \"entries\": [\n    {\n      \"id\": \"led_1q0a4b8c7f3k2m9x\",\n      \"at\": \"2026-09-23T10:41:07.512Z\",\n      \"delta\": -1,\n      \"balance_after\": 96,\n      \"reason\": \"search\",\n      \"description\": \"Product search\"\n    },\n    {\n      \"id\": \"led_0a4b8c7f3k2m9x1q\",\n      \"at\": \"2026-09-23T10:02:55.103Z\",\n      \"delta\": 100,\n      \"balance_after\": 100,\n      \"reason\": \"signup_grant\",\n      \"description\": \"Welcome grant\"\n    }\n  ]\n}\n```\n\nEntries are newest first. `limit` is 1–200, default 50. Reasons: `signup_grant`, `verify_grant`, `search`, `product_lookup`, `price_history`, `coupon_lookup`, `plan_builder`, `plan_scale`, `admin_adjustment`, `refund`."
}