---
title: "Get preview credit balance"
method: GET
path: "/v1/design_studio/inbox_previews/credits"
tags: ["Design Studio emails"]
---

# Get preview credit balance

`GET /v1/design_studio/inbox_previews/credits`

Returns your account's credit balance for inbox previews. Your credit balance determines how many previews you can generate in your account.

Learn more about [how inbox previews use credits](/accounts/billing/inbox-previews/).

## Response `200`

Successful response

- object
  - `credits` InboxPreviewCreditPool[]
    - `tier` 'free' | 'paid' — The credit tier this pool belongs to. The [`free` tier](/accounts/billing/inbox-previews/) covers two kinds of pools, the monthly allowance of 25 credits every account gets and any free pools Customer.io support has granted. Because of that, `free` can appear more than once in the response. The `paid` tier covers credits purchased for the account.
    - `credits_original` integer — Credits originally granted for a tier.
    - `credits_remaining` integer — Credits left to spend from this tier.
    - `expires_at` integer, nullable — When this pool's credits expire, if ever. Expiry is set per pool, not per tier—a purchased pool typically doesn't expire, but a free pool support granted can carry an expiration date. The monthly allowance's `expires_at` also reads `null` when Customer.io can't resolve your current billing period; that's a transient read issue, not a sign the allowance never expires.

## Other responses

- `401` — Unauthorized - missing or invalid API key
- `404` — Inbox previews aren't enabled for your account.
- `429` — Over the App API's shared limit of 10 requests per second per workspace—the same bucket every call in your workspace that isn't separately rate limited draws from, writes included. The response carries a `Retry-After` header.

## Changes

- **2026-09-17** `b2a806105969` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/changes/v1/design_studio/inbox_previews/credits/get.md)

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/revisions/d9edec5f938c?raw)