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

# Get credit balance

`GET /v1/credits`

## Request

- Base URL: `https://api.markifact.com`
- URL: `https://api.markifact.com/v1/credits`
- Auth: HTTP bearer

Current credit balance for the team.

## Response `200`

Balance returned.

- CreditBalance
  - `credits_limit` integer, required: Credits included in the plan for the current period.
  - `credits_used` integer, required: Credits consumed so far this period.
  - `credits_remaining` integer, required: credits_limit minus credits_used. Can be negative: a run that overshoots is not rolled back.
  - `billing_period_end` integer, nullable: When the period ends and usage resets, in Unix seconds.
  - `tier` string, required: Current plan.

## Other responses

- `401`: Invalid API key.
- `404`: Team not found.

---

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