---
title: "Upcoming Charges"
method: GET
path: "/subscription/api/v1/subscriptions/{id}/upcoming?count=5"
tags: ["Subscription Reads"]
---

# Upcoming Charges

`GET /subscription/api/v1/subscriptions/{id}/upcoming?count=5`

It returns the upcoming scheduled charges for a subscription.

## Path parameters

- `id` integer, required

## Query parameters

- `count` integer, required

## Response `200`

Request Successful

- UpcomingChargesResponse
  - `success` boolean — Indicates if the request was successful.
  - `message` string — Descriptive message regarding the operation.
  - `data` object[] — An ordered list containing upcoming projected billing charge dates and amounts.
    - `chargeDate` string, date-time — The scheduled future timestamp when the automated billing engine will attempt deduction.
    - `amount` number — The financial amount expected to be debited for this specific cycle occurrence.
    - `currency` string — The 3-letter ISO code denoting currency context.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/versions/1ecd4b94ff07/schema)