> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fungies.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Upcoming Subscription Payment

> Preview the amount and date of the Subscription's next renewal charge.

    Returns null when the Subscription is not active or is set to cancel at the end of the current
    interval — in both cases there is no upcoming charge to preview.

    The amount reflects Stripe's live invoice preview at request time and can still change before the
    charge actually happens (e.g. proration from a mid-cycle plan change, a coupon expiring, or tax
    recalculation) — it is a forecast, not a guarantee.



## OpenAPI

````yaml /api-reference/api-docs.yaml get /v0/subscriptions/{subscriptionIdOrNumber}/upcomingPayment
openapi: 3.1.0
info:
  title: Fungies API v0
  version: 0.3.5
servers:
  - url: https://api.fungies.io
security: []
tags:
  - name: discounts
    description: Discounts related endpoints
  - name: keys
    description: Offer product keys related endpoints
  - name: orders
    description: Orders related endpoints
  - name: payments
    description: Payments related endpoints
  - name: offers
    description: Offers related endpoints
  - name: products
    description: Products related endpoints
  - name: subscriptions
    description: Subscriptions related endpoints
  - name: tax
    description: Tax calculation related endpoints
  - name: users
    description: Users related endpoints
  - name: variants
    description: Product variants related endpoints
  - name: plans
    description: Product plans related endpoints
  - name: elements
    description: Elements related endpoints
paths:
  /v0/subscriptions/{subscriptionIdOrNumber}/upcomingPayment:
    get:
      tags:
        - subscriptions
      summary: Get Upcoming Subscription Payment
      description: |-
        Preview the amount and date of the Subscription's next renewal charge.

            Returns null when the Subscription is not active or is set to cancel at the end of the current
            interval — in both cases there is no upcoming charge to preview.

            The amount reflects Stripe's live invoice preview at request time and can still change before the
            charge actually happens (e.g. proration from a mid-cycle plan change, a coupon expiring, or tax
            recalculation) — it is a forecast, not a guarantee.
      operationId: GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPayment
      parameters:
        - name: subscriptionIdOrNumber
          in: path
          required: true
          description: Subscription ID or order number
          schema:
            $ref: >-
              #/components/schemas/GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPaymentParameterSubscriptionIdOrNumber
      responses:
        '200':
          description: >-
            GET /v0/subscriptions/:subscriptionIdOrNumber/upcomingPayment
            Positive response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPaymentPositiveResponse
        '400':
          description: >-
            GET /v0/subscriptions/:subscriptionIdOrNumber/upcomingPayment
            Negative response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPaymentNegativeResponse
              examples:
                example1:
                  value:
                    status: error
                    error:
                      message: Sample error message
      security:
        - APIKEY_1: []
components:
  schemas:
    GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPaymentParameterSubscriptionIdOrNumber:
      type: string
      description: Subscription ID or order number
    GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPaymentPositiveResponse:
      type: object
      properties:
        status:
          type: string
          const: success
        data:
          type: object
          properties:
            upcomingPayment:
              type:
                - object
                - 'null'
              properties:
                value:
                  type:
                    - integer
                    - 'null'
                  format: int64
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                  default: 0
                currency:
                  type:
                    - string
                    - 'null'
                  enum:
                    - AFN
                    - ALL
                    - DZD
                    - AOA
                    - ARS
                    - AMD
                    - AWG
                    - AUD
                    - AZN
                    - BSD
                    - BDT
                    - BBD
                    - BZD
                    - BMD
                    - BOB
                    - BAM
                    - BWP
                    - BRL
                    - BHD
                    - GBP
                    - BND
                    - BGN
                    - BIF
                    - BYN
                    - KHR
                    - CAD
                    - CVE
                    - KYD
                    - KWD
                    - XAF
                    - XPF
                    - CLP
                    - CNY
                    - COP
                    - KMF
                    - CDF
                    - CRC
                    - HRK
                    - CZK
                    - DKK
                    - DJF
                    - DOP
                    - XCD
                    - EGP
                    - ETB
                    - EUR
                    - FKP
                    - FJD
                    - GMD
                    - GEL
                    - GIP
                    - GTQ
                    - GNF
                    - GYD
                    - HTG
                    - HNL
                    - HKD
                    - HUF
                    - ISK
                    - INR
                    - IDR
                    - ILS
                    - JMD
                    - JPY
                    - JOD
                    - KZT
                    - KES
                    - KGS
                    - LAK
                    - LBP
                    - LSL
                    - LRD
                    - MOP
                    - MKD
                    - MGA
                    - MWK
                    - MYR
                    - MVR
                    - MRO
                    - MUR
                    - MXN
                    - MDL
                    - MNT
                    - MAD
                    - MZN
                    - MMK
                    - NAD
                    - NPR
                    - ANG
                    - TWD
                    - NZD
                    - NIO
                    - NGN
                    - NOK
                    - OMR
                    - PKR
                    - PAB
                    - PGK
                    - PYG
                    - PEN
                    - PHP
                    - PLN
                    - QAR
                    - RON
                    - RUB
                    - RWF
                    - SHP
                    - SVC
                    - WST
                    - STD
                    - SAR
                    - RSD
                    - SCR
                    - SLL
                    - SGD
                    - SBD
                    - SOS
                    - ZAR
                    - KRW
                    - LKR
                    - SRD
                    - SZL
                    - SEK
                    - CHF
                    - TJS
                    - TZS
                    - THB
                    - TND
                    - TOP
                    - TTD
                    - TRY
                    - UGX
                    - UAH
                    - AED
                    - UYU
                    - USD
                    - UZS
                    - VUV
                    - VEF
                    - VND
                    - XOF
                    - YER
                    - ZMW
                    - SLE
                    - XCG
                    - SSP
                    - VES
                    - MRU
                    - STN
                    - VED
                  default: null
                currencyDecimals:
                  type:
                    - integer
                    - 'null'
                  format: int64
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                  default: null
                chargeDate:
                  type:
                    - integer
                    - 'null'
                  format: int64
                  minimum: 0
                  maximum: 9007199254740991
              required:
                - chargeDate
          required:
            - upcomingPayment
      required:
        - status
        - data
    GetV0SubscriptionsSubscriptionIdOrNumberUpcomingPaymentNegativeResponse:
      type: object
      properties:
        status:
          type: string
          const: error
        error:
          type: object
          properties:
            message:
              type: string
          required:
            - message
      required:
        - status
        - error
  securitySchemes:
    APIKEY_1:
      type: apiKey
      in: header
      name: x-fngs-public-key

````