Orders and invoices

View as Markdown

In short

With the orders:read scope, GET /orders lists completed orders and GET /orders/{id} returns one, GET /invoices/{number} returns an invoice, receipt or credit note, and GET /invoices/{number}/pdf downloads it as a PDF.

All endpoints need the orders:read scope.

Method Path What it does
GET /orders List completed orders
GET /orders/{id} One order
GET /invoices/{number} An invoice, receipt or credit note, by its number
GET /invoices/{number}/pdf The same document as a PDF

Only orders that were paid and completed are returned, including ones since fully or partly refunded. Baskets and failed payments never appear. All money is a decimal string in the order's currency ("45.00"), never a number in pence. currency is an ISO 4217 code such as GBP; it is no longer always GBP, and orders placed before a team changed currency keep theirs, so read it on every order.

The order object

{
  "id": 9021,
  "status": "partially_refunded",
  "total": "45.00",
  "subtotal": "50.00",
  "discount": "5.00",
  "tax": "0.00",
  "amount_refunded": "15.00",
  "coupon": { "code": "MEMBER10" },
  "currency": "GBP",
  "invoice_number": "INV-00042",
  "items": [
    { "type": "course", "id": 412, "title": "Food Safety Level 2", "quantity": 1, "unit_price": "50.00", "tax_rate": "0.00" }
  ],
  "completed_at": "2026-11-09T14:33:54+00:00",
  "created_at": "2026-11-09T14:31:02+00:00",
  "updated_at": "2026-11-12T09:02:11+00:00",
  "user": { "id": 2, "email": "[email protected]", "name": "Sam Patel", "external": { "id": "M-1042", "source": "acme" } }
}
Field Description
status completed, partially_refunded or refunded.
subtotal, discount, tax, total subtotal and discount are before VAT, so subtotal - discount + tax = total.
amount_refunded The total returned to the buyer so far.
coupon { "code": "..." } when a discount code was used, otherwise null.
invoice_number The invoice issued for the order, or null when the team doesn't issue invoices. Fetch it with /invoices/{number}.
items type is course, bundle, event_ticket, programme or other. tax_rate is the VAT percentage, or null on orders placed before rates were recorded.
user The buyer in the compact user shape, or null for a guest checkout.

List orders

Query parameter Description
status completed, partially_refunded or refunded.
updated_since ISO 8601. Orders created or changed since then, which includes new refunds. Use it for incremental syncs.
user_id One buyer's orders.
limit, cursor See Pagination. Ordered by order id, oldest first.

An invalid filter returns 422 with error.code invalid_filter. An order from another team, or one that was never completed, returns 404.

curl "https://your-team.continuumlearn.com/api/v2/orders?updated_since=2026-11-01T00:00:00Z&limit=100" \
  -H "Authorization: Bearer $CONTINUUM_API_KEY"

Invoices and credit notes

GET /invoices/{number} works for invoices, receipts (issued by teams that aren't VAT registered) and credit notes. type is invoice or credit_note.

{
  "type": "credit_note",
  "number": "CN-00003",
  "issued_at": "2026-11-12T09:02:12+00:00",
  "currency": "GBP",
  "subtotal": "15.00",
  "discount": "0.00",
  "tax": "0.00",
  "total": "15.00",
  "reverse_charge": false,
  "order_id": 9021,
  "credits_invoice_number": "INV-00042",
  "lines": [
    { "description": "Food Safety Level 2", "quantity": 1, "unit": "15.00", "discount": "0.00", "net": "15.00", "rate": "0.00", "tax": "0.00" }
  ],
  "user": { "id": 2, "email": "[email protected]", "name": "Sam Patel", "external": { "id": "M-1042", "source": "acme" } }
}

credits_invoice_number is set on credit notes only. Documents are frozen when issued: editing the team's billing details later never changes them. GET /invoices/{number}/pdf returns the same document as application/pdf, in the buyer's language. A number from another team returns 404.

Staying up to date

Subscribe to the order.completed, order.refunded, invoice.issued and credit_note.issued webhooks and fetch the full document here when you need it.

Frequently asked questions

Why is invoice_number null?

The team doesn't issue invoices, or the invoice hasn't been issued yet. An invoice.issued webhook follows when it is.

Are amounts in pence?

No. Every amount is a decimal string in the order's currency (the major unit, such as pounds or dollars), for example "45.00".

Building an integration?

Tell us what you are connecting and we will help you plan it, or book a demo to see the API working.