---
title: "Get current BeReach credit balance"
method: GET
path: "/me/credits"
tags: ["profile"]
---

# Get current BeReach credit balance

`GET /me/credits`

Returns the current credit balance for the workspace. Includes credits used, total limit, remaining credits, usage percentage, and whether credits are unlimited. When isUnlimited is true, limit and remaining are null — skip credit budgeting.

## Response `200`

Credit balance for the workspace

- object
  - `success` true, required
  - `credits` object, required
    - `current` integer, required — Number of credits used in the current billing period
    - `limit` integer, nullable, required — Maximum credits available for the workspace, or null if unlimited
    - `remaining` integer, nullable, required — Credits remaining before hitting the limit, or null if unlimited
    - `percentage` number, required — Percentage of credits used (0-100, capped at 100, rounded to 2 decimal places). 0 when unlimited
    - `isUnlimited` boolean, required — Whether the workspace has unlimited credits (Pro plan). When true, limit and remaining are null
  - `creditsUsed` integer, required — Credits consumed by this call (0 for free endpoints, cached results, or duplicates).
  - `retryAfter` integer, required — Seconds to wait before making another call of the same type. 0 means no wait needed.

## Other responses

- `400` — The server cannot or will not process the request due to something that is perceived to be a client error.
- `401` — Although HTTP specifies "unauthorized", this response means "unauthenticated". Authenticate to continue. NOTE: 401 is also returned with code "linkedin_not_connected" when the caller IS authenticated but has no connected LinkedIn account — connect LinkedIn (not re-authenticate) to continue.
- `403` — The client does not have access rights to the content.
- `404` — The server cannot find the requested resource.
- `409` — The request conflicts with the current state of the server.
- `410` — The requested content has been permanently deleted from the server.
- `422` — The request was well-formed but was unable to be followed due to semantic errors.
- `429` — Rate limit exceeded. Read error.retryAfter for the wait time in seconds.
- `500` — The server encountered a situation it does not know how to handle.
- `502` — LinkedIn returned a server error or the proxy connection failed. Retry after a few seconds.
- `503` — Proxy capacity temporarily exceeded. Retry after a few seconds.

---

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