---
title: "Paginated charge list for one subscription"
method: GET
path: "/v1/subscriptions/{id}/charges"
---

# Paginated charge list for one subscription

`GET /v1/subscriptions/{id}/charges`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/subscriptions/{id}/charges`
- Auth: API key in header `X-User-Token`

## Path parameters

- `id` integer, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Charges, newest first (X-Total-Count / X-Total-Pages headers)

- object[]
  - `id` integer
  - `number` string
  - `amount` string
  - `status` 'pending' | 'processing' | 'paid' | 'failed' | 'refunded'
  - `invoice_url` string, nullable
  - `paid_at` string, date-time, nullable
  - `currency_code` string

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)