---
title: "Get Credits"
method: GET
path: "/api/v1/credits"
tags: ["v1", "billing"]
---

# Get Credits

`GET /api/v1/credits`

## Request

- Base URL: `https://zsign.io` (the document declares no server; this is the origin it was published from)
- URL: `https://zsign.io/api/v1/credits`
- Auth: HTTP bearer

Current credit balance plus the purchasable packs.

Also echoes this account's own referral_code/referral_url -- the "narrow
ambient" surface for the referral program (see mcp_server/tools.py's
get_referral_link for the pull surface). An agent that's already calling
check_balance for its human learns the code for free, no extra round
trip, and with no pitch text attached: this is pure account state, the
same as balance itself. Nothing else about this endpoint changes.

## Response `200`

Successful Response

- AgentCreditBalanceResponse: GET /api/v1/credits — API-key twin, plus this account's referral.
  - `balance` integer, required
  - `packs` object, required
  - `referral_code` string, nullable
  - `referral_url` string, nullable

---

[API](https://skmtc.dev/zsign/apis/zsign-api.md) · [All operations](https://skmtc.dev/zsign/apis/zsign-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zsign/apis/zsign-api/revisions/a674ac4137ba?raw)