---
title: "Get upcoming invoice"
method: GET
path: "/subscriptions/upcoming-invoice/{appId}"
tags: ["Subscriptions"]
---

# Get upcoming invoice

`GET /subscriptions/upcoming-invoice/{appId}`

## Request

- Base URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api`
- URL: `https://us-central1-paymentgateway-ab783.cloudfunctions.net/api/subscriptions/upcoming-invoice/{appId}`
- Auth: HTTP bearer

Retrieve the next scheduled invoice for the specified app subscription.

## Path parameters

- `appId` string, required

## Response `200`

Upcoming invoice retrieved

- object
  - `success` boolean
  - `invoice` object, nullable
    - `amount` number
    - `currency` string
    - `periodStart` string, date-time
    - `periodEnd` string, date-time
    - `nextPaymentAttempt` string, date-time

## Other responses

- `401`: Missing or invalid authentication token
- `500`: Failed to fetch upcoming invoice

---

[API](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api.md) · [All operations](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futuresenseai/apis/futuresense-ai-central-hub-api/revisions/53e075911af9?raw)