List subscription invoices

List the invoices raised for subscriptions, newest first. Read only.

GEThttps://app.softsolz.uk/api/v1/services/catalog/catalog/invoices

Recent Requests

Kept only in this browser

TimeStatusTook

Send a request with Try it to see it here.

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Query Params

statusstring

Only invoices in this status, for example open, paid or past_due.

subscription_idstring

Only invoices for this subscription.

contact_idstring

Only invoices for this contact.

limitinteger

Page size, 1-200 (default 50).

offsetinteger

Number of invoices to skip (default 0).

Response

Response Body · array of objects

idstringInvoice id.

subscription_idstring | nullSubscription the invoice belongs to.

contact_idstring | nullContact being billed.

contact_namestring | nullFull name of that contact.

company_idstring | nullCompany being billed.

numberstringInvoice number shown to the customer.

statusstringWhere the invoice is.

currencystringThree-letter currency code.

subtotal_centsintegerTotal before discount and tax.

discount_centsintegerDiscount taken off.

tax_centsintegerTax charged.

total_centsintegerAmount due in total.

amount_paid_centsintegerAmount paid so far.

credit_applied_centsintegerCredit from credit notes used on this invoice.

period_startstring | nullStart of the period billed.

period_endstring | nullEnd of the period billed.

issued_atstring | nullWhen the invoice was issued.

due_atstring | nullWhen payment is due.

paid_atstring | nullWhen the invoice was paid.

attempt_countintegerHow many times payment has been tried.

next_attempt_atstring | nullWhen payment will be tried next.

created_atstringWhen the invoice was created.

linesarray of objectsThe lines on the invoice. Only returned when you fetch one invoice.

Request

curl --request GET \
  --url https://app.softsolz.uk/api/v1/services/catalog/catalog/invoices \
  --header 'Authorization: Bearer sk_live_your_key'

Credentials

Authorization

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": [
    {
      "id": "412",
      "subscription_id": "88",
      "contact_id": "7d3f2b1a-9c4e-4f6a-8b2d-1e5c7a9b0f12",
      "contact_name": "Jane Doe",
      "company_id": null,
      "number": "SUB-0007",
      "status": "paid",
      "currency": "GBP",
      "subtotal_cents": 2900,
      "discount_cents": 0,
      "tax_cents": 580,
      "total_cents": 3480,
      "amount_paid_cents": 3480,
      "credit_applied_cents": 0,
      "period_start": null,
      "period_end": null,
      "issued_at": null,
      "due_at": null,
      "paid_at": null,
      "attempt_count": 1,
      "next_attempt_at": null,
      "created_at": "2026-10-01T09:00:00.000Z",
      "lines": [
        {
          "id": "301",
          "product_id": "17",
          "price_id": null,
          "description": "Pro plan",
          "quantity": 1,
          "unit_price_cents": 2900,
          "amount_cents": 2900,
          "tax_rate_percent": 20,
          "tax_cents": 580,
          "is_proration": false,
          "period_start": null,
          "period_end": null
        }
      ]
    }
  ],
  "meta": {
    "limit": 50,
    "offset": 0,
    "total": 1,
    "has_more": false
  }
}