---
title: "Retrieve credit usage for a brand"
method: GET
path: "/brands/{brand_id}/usage"
tags: ["Brands"]
---

# Retrieve credit usage for a brand

`GET /brands/{brand_id}/usage`

## Path parameters

- `brand_id` integer, required

## Response `200`

Brand usage retrieved successfully.

- BrandUsage
  - `brand_id` integer
  - `brand_name` string
  - `total_credits` integer
  - `credits_used` integer
  - `credits_available` integer
  - `message_credit_limit` integer, nullable
  - `message_credit_limit_percentage` integer, nullable

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/slicktext/apis/slicktext-api-new-platform.md) · [All operations](https://skmtc.net/slicktext/apis/slicktext-api-new-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slicktext/slicktext-api-new-platform/revisions/6f6c30f01b42/schema)