---
title: "Get Credits"
method: GET
path: "/marble/v1/credits"
tags: ["credits"]
---

# Get Credits

`GET /marble/v1/credits`

## Request

- Base URL: `https://api.worldlabs.ai`
- URL: `https://api.worldlabs.ai/marble/v1/credits`
- Auth: API key in header `WLT-Api-Key`
- TypeScript: <https://skmtc.dev/worldlabs/apis/marble-public-api-v1/docs/marble/v1/credits/get.ts> (a function with typed inputs; its response is checked against the schema)

Get remaining API credits for the authenticated user.

Returns:
    CreditsResponse with the current aggregate API credit balance.

Raises:
    HTTPException: 404 if the caller is not an API-enabled user
    HTTPException: 503 if the billing backend is unavailable

## Response `200`

Successful Response

- CreditsResponse: Remaining credits for the authenticated API user.
  - `remaining_credits` number, required: Remaining API credits available to the authenticated user.

---

[API](https://skmtc.dev/worldlabs/apis/marble-public-api-v1.md) - [All operations](https://skmtc.dev/worldlabs/apis/marble-public-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/worldlabs/apis/marble-public-api-v1/revisions/4a3ed614672e?raw)