---
title: "Get invoices for a subscription (deprecated)"
method: GET
path: "/subscriptions/{subscriptionId}/invoices"
tags: ["Subscriptions"]
deprecated: true
---

# Get invoices for a subscription (deprecated)

`GET /subscriptions/{subscriptionId}/invoices`

> **Deprecated.**

DEPRECATED - Use GET /subscriptions/invoices instead.
            
Retrieves invoices for the specified subscription.
            
Invoices are returned sorted by creation date with the most recent invoices appearing first.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `limit` integer

## Response `200`

When request is successful. Returns a collection of 'SubscriptionInvoice' objects.

- SubscriptionInvoiceCollection
  - `id` string, nullable
  - `href` string, nullable
  - `relation` string, nullable
  - `method` string, nullable
  - `self` Link
    - `id` string, nullable
    - `href` string, nullable
    - `relation` string, nullable
    - `method` string, nullable
  - `value` SubscriptionInvoice[], nullable
    - `id` string, nullable — The unique identifier of the invoice.
    - `number` string, nullable — The human-readable invoice number (e.g. ABC-001).
    - `status` string — The invoice status.
    - `description` string, nullable — The invoice description.
    - `total` integer — The total amount for the invoice.
    - `subTotal` integer — The payment subtotal amount.
    - `tax` integer — The payment tax amount.
    - `preTaxCredit` integer — Total pre-tax credits applied to this payment.
    - `lineItems` SubscriptionInvoiceLineItem[], nullable — The line items associated to the invoice.
      - `product` Link
        - `id` string, nullable
        - `href` string, nullable
        - `relation` string, nullable
        - `method` string, nullable
      - `description` string, nullable — Description of this line item.
      - `interval` string — Recurring payment interval type.
      - `amount` integer — The amount charged for this line item.
      - `tax` integer — The tax amount in this line item.
      - `preTaxCredit` integer — Any credit amount on this line item.
      - `quantity` integer, nullable — The number of users for this line item.
    - `createdDate` string, date-time — The created date of the invoice.

## Other responses

- `404` — When subscription with specified id does not exist.
- `500` — When an error occurs while retrieving the subscription invoices.

---

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