---
title: "Get account credit balances"
method: GET
path: "/credits"
tags: ["Account"]
---

# Get account credit balances

`GET /credits`

## Request

- Base URL: `https://api.salesforge.ai/public/v2`
- URL: `https://api.salesforge.ai/public/v2/credits`
- Auth: API key in header `Authorization`

Returns account-wide balances for email, lead, personalization, email_validation and social_action, including remaining, max, used and the current tier. Max is the plan allowance plus tier credits for the billing period. Annual plans include 12 months of credits, while lead capacity stays the same. Lead credits show capacity for additional active contacts across all workspaces, excluding agent contacts. Remaining can be negative when over capacity. For other credits, used is max minus remaining, with a minimum of zero; bonus credits can increase remaining above max. Agent and browser-extension/Leadsforge quotas are excluded.

## Response `200`

OK

- ApiAccountCreditsResponse
  - `credits` ApiAccountCreditBalance[]
    - `max` integer
    - `remaining` integer
    - `tierId` string
    - `type` 'email' | 'lead' | 'personalization' | 'email_validation' | 'social_action'
    - `used` integer

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `500`: Internal Server Error

---

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