---
title: "List Subscription Balance Entries"
method: GET
path: "/subscriptions/{subscription_id}/subscription_balance_entries"
tags: ["Subscriptions"]
---

# List Subscription Balance Entries

`GET /subscriptions/{subscription_id}/subscription_balance_entries`

Retrieve a list of `Subscription Balance Entry` resources to view a timeline of all changes to a `Subscription` balance by a user. Currently, only credits can modify a `Subscription` balance.

For details on how to query endpoints using the available parameters, see [Query Parameters](/api/overview/#section/Query-Parameters).

## Query parameters

- `after_cursor` string
- `amount` integer
- `amount.gt` integer
- `amount.gte` integer
- `amount.lt` integer
- `amount.lte` integer
- `before_cursor` string
- `created_at.gte` string, date-time
- `created_at.lte` string, date-time
- `limit` integer
- `sort` string
- `tags.key` string
- `tags.value` string
- `updated_at.gte` string, date-time
- `updated_at.lte` string, date-time

## Headers

- `Finix-Version` string

## Response `200`

List of `Subscription Balance Entry` resources

- object
  - `page` Page — Details the page that's returned.
    - `limit` integer — The number of entries to return.
    - `next_cursor` string, nullable — The cursor to use for the next page of results.
  - `_embedded` object
    - `subscription_balance_entries` SubscriptionBalanceEntry[]
      - `id` string — The ID of the resource.
      - `created_at` string, date-time — Timestamp of when the object was created.
      - `updated_at` string, date-time — Timestamp of when the object was last updated.
      - `amount` integer — The total amount that will be debited in cents (e.g. 100 cents to debit $1.00).
      - `currency` 'USD' — ISO 4217 3-letter currency code. Currently, the only `currency` supported is `USD`.
      - `description` string — Describes the circumstances for the subscription credit.
      - `subscription_id` string — The `Subscription` that was credited.
      - `type` string — The value of this field will always be `CREDIT`.
      - `tags` Tags, nullable — Include up to 50 `key: value` pairs to annotate requests with custom metadata. - Maximum character length for individual `keys` is 40. - Maximum character length for individual `values` is 500. (For example, `order_number: 25`, `item_type: produce`, `department: sales`)
  - `_links` object
    - `self` Self — Link to the resource that was used in the request.
      - `href` string
    - `next` Next — Link to the next page of entries.
      - `href` string

## Other responses

- `401` — Unauthorized. Authentication is required and has failed or has not been provided.
- `403` — Forbidden. The client is authenticated but does not have permission to access the resource.
- `404` — Not Found. The requested resource could not be found on the server.
- `406` — Not Acceptable. The server could not accept the submitted request. Confirm how the request was formatted and submitted.

---

[API](https://skmtc.net/finix/apis/finix-api-reference.md) · [All operations](https://skmtc.net/finix/apis/finix-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/finix/finix-api-reference/versions/67e4dc871bfc/schema)