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

# Get credits

`GET /credits`

## Request

- Base URL: `https://api.autumn.ai`
- URL: `https://api.autumn.ai/credits`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Credit balance and account identity.

## Response `200`

Credit balance and account identity.

- CreditsResponse
  - `plan` string, nullable
  - `unlimited` boolean, required
  - `credits_remaining` integer, nullable
  - `credits_used` integer, nullable
  - `credits_total` integer, nullable
  - `monthly_credits` integer, nullable
  - `billing_reset_at` string, nullable
  - `user_id` string, required
  - `email` string, nullable
  - `account` object, nullable

## Other responses

- `401`: `unauthorized`: Missing or invalid credentials. Send your full API key as `X-API-Key: <key>` or `Authorization: Bearer <key>`.
- `503`: `auth_unavailable`: Key verification is temporarily unavailable. Wait `retry_after` seconds, then send the request again. | `service_unavailable`: Autumn is temporarily unavailable. Wait `retry_after` seconds, then send the request again.

---

[API](https://skmtc.dev/autumn-ai/apis/autumn-task-api.md) - [All operations](https://skmtc.dev/autumn-ai/apis/autumn-task-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autumn-ai/apis/autumn-task-api/revisions/78fb43699783?raw)