---
title: "List credits given to a subscriber"
method: GET
path: "/gateway/subscriptions/{id}/credits"
tags: ["Subscriptions"]
---

# List credits given to a subscriber

`GET /gateway/subscriptions/{id}/credits`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/subscriptions/{id}/credits`
- Auth: `SessionAuth` (a scheme the document does not define)

Every credit given for this subscription, newest first, and what is left unspent. `balanceMinor` is the customer's whole unspent credit with you, which may include credit given for another of their subscriptions. `createdBy` is the id of the person who gave it. `currency` is the subscription's, and every minor-unit figure on the page is counted in it. Owner or admin, signed-in session only: an API key is refused here, same as on the grant.

## Path parameters

- `id` string, uuid, required

## Response `200`

The credits given for this subscription.

- SubscriptionCreditListResponse
  - `items` object[], required
    - `id` string, required
    - `amountMinor` integer, required
    - `reason` string, required
    - `createdBy` string, uuid, nullable, required: The id of the person who gave it. Null when the credit was not given through AgentaOS but directly at the card processor, so there is nobody of ours to name.
    - `createdAt` string, date-time, required
  - `balanceMinor` integer, required: Unspent credit on the CUSTOMER, which may span their subscriptions with you.
  - `currency` string, required: What every minor-unit figure on this page is counted in — the subscription's own currency, lower-case ISO 4217. Print it; don't assume one.

## Other responses

- `401`: Missing or invalid `x-api-key`.
- `403`: The key is valid but the resource belongs to a different organization.
- `404`: Resource not found (or not visible to your key; the two are not distinguished).

---

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