Get the wallet

Returns the workspace’s credit balance and wallet state. A workspace that has no credits granted yet reads as not activated. Funding happens in the dashboard: API credentials can read the wallet but never fund it. Needs the billing:read scope.

GET/billing/wallet

Authorization

AuthorizationBearer token · headerrequired

API key sent as Authorization: Bearer <key>. A key belongs to one workspace, has scopes, and can be limited to some brands.

AuthorizationOAuth2 access token · headerrequired

OAuth 2.1 sign-in (authorization code with PKCE) used by AI assistants that connect through the Zaraftis MCP server. Discovery URLs are at https://api.zaraftis.com/api/auth.

Responses

200

The wallet's credit facts

WalletEnvelope

Request

curl -X GET 'https://api.zaraftis.com/v1/billing/wallet' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.zaraftis.com/v1/billing/wallet", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.zaraftis.com/v1/billing/wallet",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

The wallet's credit facts