---
title: "The organization's pentest credit balance"
method: GET
path: "/credits"
tags: ["REST API - Credits"]
---

# The organization's pentest credit balance

`GET /credits`

## Request

- Base URL: `https://api.hacktron.ai/v1`
- URL: `https://api.hacktron.ai/v1/credits`
- Auth: API key in header `X-Api-Key`

## Response `200`

- PentestCreditBalanceResponseDto
  - `organization_id` string, required: Organization UUID
  - `balance` number, required: Current pentest credit balance available for use
  - `total_purchased` number, required: Total pentest credits purchased across all time
  - `total_used` number, required: Total pentest credits deducted for completed/running pentests
  - `total_refunded` number, required: Total pentest credits refunded from cancelled pentests
  - `total_granted` number, required: Total pentest credits granted at no charge
  - `used_this_period` number, nullable, required: Credits deducted since the start of the current billing period, null when the organization has no billing period
  - `is_unlimited` boolean, required: Whether this organization has internal unlimited pentest entitlement

## Changes

- **2026-11-03** `48b2f95b2320`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hacktron/apis/hacktron-rest-api/changes/credits/get.md)

---

[API](https://skmtc.dev/hacktron/apis/hacktron-rest-api.md) - [All operations](https://skmtc.dev/hacktron/apis/hacktron-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hacktron/apis/hacktron-rest-api/revisions/48b2f95b2320?raw)