---
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`

## Request

- Base URL: `https://api.smokeball.com`
- URL: `https://api.smokeball.com/subscriptions/{subscriptionId}/invoices`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

> **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. Possible values: Draft, Open, Paid, Unpaid, Void, Closed
    - `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: Billing interval associated to this line item. Possible values: None, Daily, Weekly, Monthly, Yearly.
      - `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.
      - `periodStart` string, date-time, nullable: The start of the billing period for this line item.
      - `periodEnd` string, date-time, nullable: The end of the billing period 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.

## Changes

- **2026-10-28** `2fe552c5d11d`: 2 info
  - added the optional property `value/items/lineItems/items/periodEnd` to the response with the `200` status
  - added the optional property `value/items/lineItems/items/periodStart` to the response with the `200` status

[Operation history](https://skmtc.dev/smokeball/apis/smokeball-api/changes/subscriptions/:subscriptionId/invoices/get.md)

---

[API](https://skmtc.dev/smokeball/apis/smokeball-api.md) - [All operations](https://skmtc.dev/smokeball/apis/smokeball-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smokeball/apis/smokeball-api/revisions/6e350cf667d4?raw)