---
title: "Credit Balance"
method: GET
path: "/gateway/v1/me/credits"
tags: ["Account"]
---

# Credit Balance

`GET /gateway/v1/me/credits`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/me/credits`
- Auth: HTTP bearer

Returns the remaining credit balance of the workspace that owns the API key. Requires an API key. Free: costs 0 credits and is not recorded in usage history, but counts toward the rate limit.

## Response `200`

OK

- DataObjectResponseMeCreditsData
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` MeCreditsData, required
    - `credit_balance` integer, required: Remaining credits of the workspace that owns the API key
  - `meta` ObjectResponseMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable

## Other responses

- `default`: Error

## Changes

- **2026-10-23** `cd899b4049b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/changes/gateway/v1/me/credits/get.md)

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)