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".