---
title: "Read the current credit balance"
method: GET
path: "/v1/credits"
tags: ["Credits"]
---

# Read the current credit balance

`GET /v1/credits`

## Request

- Base URL: `https://api.asoskill.com`
- URL: `https://api.asoskill.com/v1/credits`
- Auth: HTTP bearer

Returns the authenticated account's available credit buckets and total. This request does not cost a credit.

## Response `200`

Current credit balance; does not cost a credit

- CreditsResponse
  - `credits` CreditBalance, required
    - `paid` integer, required
    - `promotional` integer, required
    - `dailyFree` integer, required
    - `total` integer, required
    - `used` integer, required
    - `dailyFreeResetsAt` string, date-time, required
  - `topUp` object, required
    - `method` 'GET', required
    - `path` '/v1/billing/packs', required
  - `requestId` string, required

## Other responses

- `401`: The bearer credential is missing, invalid, expired, or revoked; no credit is consumed
- `403`: The account is unavailable or disabled; no credit is consumed
- `429`: Request capacity or a rate allowance was exceeded; no credit is consumed. Respect Retry-After when present, otherwise retry with exponential backoff and jitter.
- `500`: Unexpected processing failure; any reserved credit is restored

---

[API](https://skmtc.dev/asoskill/apis/aso-skill-developer-api.md) · [All operations](https://skmtc.dev/asoskill/apis/aso-skill-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/asoskill/apis/aso-skill-developer-api/revisions/c9808e5357cf?raw)