---
title: "Retrieve a user's credit balance"
method: GET
path: "/users/{user_id}/billing/credits"
tags: ["Users", "Billing"]
---

# Retrieve a user's credit balance

`GET /users/{user_id}/billing/credits`

Retrieves the current credit balance for the specified user.
Credits can be applied during checkout to reduce the charge or automatically applied to upcoming recurring charges

## Path parameters

- `user_id` string, required

## Response `200`

A payer's credit balance.

- CommerceCreditBalanceResponse
  - `object` string, required — String representing the object's type. Always "commerce_credit_balance".
  - `balance` CommerceMoneyResponse, required
    - `amount` integer, required — The amount in cents.
    - `amount_formatted` string, required — The formatted amount as a string (e.g., "$49.99").
    - `currency` string, required — The currency code (e.g., "USD").
    - `currency_symbol` string, required — The currency symbol (e.g., "$").

## Other responses

- `400` — Request was not successful
- `401` — Authentication invalid
- `403` — Authorization invalid
- `404` — Resource not found
- `422` — Invalid request parameters
- `500` — Request was not successful

---

[API](https://skmtc.net/clerk/apis/clerk-backend-api.md) · [All operations](https://skmtc.net/clerk/apis/clerk-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clerk/clerk-backend-api/revisions/cf036e7951d3/schema)