# Orders and invoices

> 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

```json
{
  "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": "sam@example.org", "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](https://continuumlearn.com/developers/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`.

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

```json
{
  "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": "sam@example.org", "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](https://continuumlearn.com/developers/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"`.
