---
title: "Get the artwork-generation credit balance"
method: GET
path: "/api/credits-balance"
tags: ["Account"]
---

# Get the artwork-generation credit balance

`GET /api/credits-balance`

## Request

- Base URL: `https://api.createprints.ai`
- URL: `https://api.createprints.ai/api/credits-balance`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.createprints.ai/api/oauth/authorize`, token URL `https://api.createprints.ai/api/oauth/token`, scopes: `orders:read`)

Returns the remaining generation-job count. This endpoint currently accepts a Create Prints MCP OAuth access token with `orders:read` or a signed-in user-session token. It does not accept an account API key.

## Response `200`

Current remaining generation credits.

- CreditsBalance
  - `generation_jobs_count` integer, nullable, required
  - `creditsRemaining` integer, nullable, required

## Other responses

- `401`: The credential is missing, invalid, revoked, or expired.
- `403`: The credential lacks the required scope or cannot perform this operation.
- `500`: Create Prints could not complete the request.

---

[API](https://skmtc.dev/createprints/apis/create-prints-api.md) · [All operations](https://skmtc.dev/createprints/apis/create-prints-api/llms.txt) · [OpenAPI document](https://skmtc.dev/createprints/apis/create-prints-api/revisions/05c57f496d51?raw)