---
title: "Retrieve public API credit usage"
method: GET
path: "/v1/credits"
tags: ["v1"]
---

# Retrieve public API credit usage

`GET /v1/credits`

## Response `200`

Successful credit usage lookup

- CreditsUsage
  - `used_credits` integer, required
  - `included_credits` integer, required
  - `remaining_credits` integer, required — Never negative; zero once usage exceeds included credits.
  - `overage_credits` integer, required — Credits above the included allowance.
  - `paid` boolean, required
  - `period` CreditsUsagePeriod, required
    - `type` 'billing_cycle' | 'rolling_30_days', required — billing_cycle for paid plans; rolling_30_days for the free plan, where the window starts with the first request.
    - `reset_at` string, date-time, required

## Other responses

- `401` — Unauthorized - Authentication required
- `500` — Internal Server Error - An error occurred while processing the request

## Changes

- **2026-07-23** `4d85d3f35061` — 1 warning, 1 info
  - added the new `rolling_30_days` enum value to the `period/type` response property for the response status `200`
  - removed the non-success response with the status `402`
- **2026-06-24** `1aebcb0cae4a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/oregister/apis/openregister-api/changes/v1/credits/get.md)

---

[API](https://skmtc.dev/oregister/apis/openregister-api.md) · [All operations](https://skmtc.dev/oregister/apis/openregister-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/oregister/openregister-api/revisions/d1fcaf6d6ca0/schema)