---
title: "Get Request balance, Wallet balance, request lots, and billing controls"
method: GET
path: "/dashboard/credits"
tags: ["Billing"]
---

# Get Request balance, Wallet balance, request lots, and billing controls

`GET /dashboard/credits`

## Request

- Base URL: `https://blockreq.com/api`
- URL: `https://blockreq.com/api/dashboard/credits`
- Auth: HTTP bearer

## Response `200`

Request and wallet state

- object
  - `code` number, required
  - `ok` boolean, required
  - `data` object, required
    - `creditState` object, required
      - `plan` 'free' | 'payg' | 'starter' | 'growth' | 'professional' | 'business' | 'enterprise', required
      - `paygEnabled` boolean, required
      - `remainingRequests` number, required
      - `walletBalanceNanoUsd` number, required
      - `currencyCode` 'USD', required
      - `usedRequests24h` number, required
      - `suggestedWalletTopUpUsd` number, required
      - `walletTopUpPresetsUsd` number[], required
      - `requestPackOptions` object[], required
        - `packageId` 'starter' | 'growth' | 'professional' | 'business', required
        - `label` string, required
        - `summary` string, required
        - `priceCents` number, required
        - `priceUsd` number, required
        - `includedRequests` number, required
        - `validDays` number, required
        - `discount` string, nullable, required
      - `nextFreeRefreshAt` string, nullable, required
      - `callAccess` object, required
        - `callsEnabled` boolean, required
        - `reasonCode` 'ok' | 'payg_zero_balance' | 'payg_fallback_to_package', required
        - `warningMessage` string, nullable, required
        - `fallbackPlan` 'free' | 'payg' | 'starter' | 'growth' | 'professional' | 'business' | 'enterprise'
      - `autoRecharge` object, required
        - `enabled` boolean, required
        - `packageId` string, nullable, required
      - `activeRequestLotsCount` number, required
      - `activeRequestLotsTotalRequests` number, required
      - `activeRequestLots` object[], required
        - `packageId` string, required
        - `label` string, required
        - `totalRequests` number, required
        - `remainingRequests` number, required
        - `usedRequests` number, required
        - `usagePercent` number, required
        - `daysRemaining` number, nullable, required
        - `expiresAt` string, nullable, required
        - `hoursRemaining` number, nullable, required
        - `depleted` boolean, required
      - `updatedAt` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Error

---

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