Invoices

To retrieve the invoices and credit notes issued for a subscription, send a GET request with the subscription id.

Endpoint: /api/public/v1/subscriptions/:subscription_id/invoices

Method: GET

Swagger https://docs.sequra.com/reference/get_api-public-v1-subscriptions-id-invoices

How the documents work

The first invoice covers the whole term of the subscription.
When the subscription changes (a product is exchanged, added or removed, or the term is extended), a credit note cancels the months not yet delivered, and a new invoice covers the new version of the subscription.
Credit notes have negative totals, so the sum of all documents is the total billed for the subscription.
Documents are ordered by issue date.
All amounts are in cents and include tax. currency gives the currency of each document.
The seQura fee is not part of these documents. seQura invoices the fee to the customer directly and sends the invoice by email.

Payload

{}

Response

[
  {
    "number": "INV-1",
    "type": "invoice",
    "issue_date": "2026-01-01",
    "currency": "EUR",
    "total_with_tax": 600,
    "lines": [
      {
        "description": "Glasses",
        "quantity": 1,
        "amount_with_tax": 800
      }
    ],
    "discounts": [
      {
        "description": "Launch offer",
        "amount_with_tax": -200
      }
    ]
  },
  {
    "number": "CN-1",
    "type": "credit_note",
    "issue_date": "2026-07-01",
    "currency": "EUR",
    "total_with_tax": -600,
    "lines": [
      {
        "description": "Glasses",
        "quantity": 1,
        "amount_with_tax": -800
      }
    ],
    "discounts": [
      {
        "description": "Launch offer",
        "amount_with_tax": 200
      }
    ]
  },
  {
    "number": "INV-2",
    "type": "invoice",
    "issue_date": "2026-07-01",
    "currency": "EUR",
    "total_with_tax": 28800,
    "lines": [
      {
        "description": "Glasses",
        "quantity": 1,
        "amount_with_tax": 28800
      }
    ],
    "discounts": []
  }
]

Field	Description
`number`	Invoice or credit note number
`type`	`invoice` or `credit_note`
`issue_date`	Issue date (`YYYY-MM-DD`)
`currency`	ISO currency code
`total_with_tax`	Document total in cents, tax included. Negative for credit notes
`lines`	One entry per product line: `description`, `quantity`, `amount_with_tax`
`discounts`	Promotions applied to the document: `description`, `amount_with_tax` (negative on invoices, positive on credit notes). Lines plus discounts add up to `total_with_tax`

A subscription that the shopper has not confirmed yet has no invoices, and returns an empty list [].

Errors

Status	Code	When
401		Invalid credentials
404	`not_found`	The subscription does not exist or belongs to another merchant
404	`simba_order_not_found`	No billing order was found for the subscription
502	`simba_unavailable`	The invoices could not be retrieved. Retry later

{
  "errors": [
    {
      "code": "not_found",
      "title": "Subscription not found"
    }
  ]
}