---
title: "Credit balance, plan and limits"
method: GET
path: "/credits"
---

# Credit balance, plan and limits

`GET /credits`

## Request

- Base URL: `https://scifig.ai/api/v1`
- URL: `https://scifig.ai/api/v1/credits`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://scifig.ai/api/auth/oauth2/authorize`, token URL `https://scifig.ai/api/auth/oauth2/token`, scopes: `credits:read`)

## Response `200`

OK

- object
  - `granted_scopes` string[]
  - `balance` integer
  - `reserved` integer
  - `plan` string
  - `plan_level` integer
  - `limits` object
    - `concurrent_tasks` integer
    - `tasks_per_hour` integer
  - `top_up_url` string, uri

## Other responses

- `429`: RATE_LIMITED (per-minute window, or a daily limit named in details.reason, e.g. DAILY_CONVERSION_LIMIT) or CONCURRENCY_LIMITED (too many running tasks). Wait Retry-After seconds and retry with the same Idempotency-Key.
- `default`: Error. Branch on error.code; never parse message. 503 responses carry Retry-After.

---

[API](https://skmtc.dev/scifig/apis/scifig-api.md) · [All operations](https://skmtc.dev/scifig/apis/scifig-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scifig/apis/scifig-api/revisions/e58cc7ec74fb?raw)