---
title: "Get your organization's credit balance and your member allowance"
method: GET
path: "/v1/credits"
tags: ["credits"]
---

# Get your organization's credit balance and your member allowance

`GET /v1/credits`

## Request

- Base URL: `https://builder.twin.so`
- URL: `https://builder.twin.so/v1/credits`
- Auth: API key in header `x-api-key`

Returns whole credits from the authenticated API key owner's organization wallet. Member usage and caps cover the UTC calendar month, independently of the wallet billing period. Null member cap and remaining allowance mean unlimited, not zero; member allowance is separate from the shared wallet balance. current_period_end is a nullable Unix timestamp in seconds. Available to any valid API key regardless of plan or remaining credits. Returns 404 when no organization wallet exists and never creates one.

## Response `200`

- CreditsResponse
  - `credits_purchased` integer, required
  - `credits_remaining` integer, required
  - `credits_used` integer, required
  - `current_period_end` integer, nullable
  - `member_period_cap_credits` integer, nullable
  - `member_period_remaining_credits` integer, nullable
  - `member_period_used_credits` integer, required
  - `organization_id` string, uuid, required
  - `period_credits_total` integer, required

## Other responses

- `401`
- `404`
- `500`

## Changes

- **2026-09-06** `675a7dce5a56`: 1 info
  - endpoint added

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

---

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