# Catalogue - courses, folders and events

> With the catalogue:read scope, GET /courses lists every course in the team (public and private, never templates), GET /courses/{id} adds the module and lesson outline, GET /course-folders lists folders and GET /events lists published events. Lesson content is never returned.

All catalogue endpoints need the `catalogue:read` scope.

| Method | Path | What it does |
|---|---|---|
| GET | `/courses` | List courses |
| GET | `/courses/{id}` | One course, with its outline |
| GET | `/course-folders` | List course folders |
| GET | `/events` | List events |
| GET | `/events/{id}` | One event |

## List courses

`GET /courses` returns every course in the team, **public and private** (see `visibility`), because a membership-system sync needs private courses to enrol people on. Course templates are never returned. (The [website embeds](https://continuumlearn.com/developers/embeds), by contrast, show public courses only.)

| Query parameter | Description |
|---|---|
| `visibility` | `public` or `private`. |
| `type` | `course`, `live` (a live course) or `publication` (reading content such as a guide). |
| `folder` | A course folder id. |
| `language` | A locale code such as `cy` or `fr-CA`. Returns courses written in that language, with no language set, or translated into it, with titles and summaries translated. |
| `updated_since` | ISO 8601 date-time. Courses whose record changed since then. |
| `limit`, `cursor` | See [Pagination](https://continuumlearn.com/developers/pagination). |

```bash
curl "https://your-team.continuumlearn.com/api/v2/courses?visibility=public&folder=12" \
  -H "Authorization: Bearer $CONTINUUM_API_KEY"
```

Each course:

```json
{
  "id": 412,
  "type": "course",
  "title": "Food Safety Level 2",
  "summary": "Everything food handlers need to know.",
  "image": "https://d3s1ce6myhihzg.cloudfront.net/...",
  "language": "en",
  "folders": [12],
  "price": { "amount": 4500, "currency": "GBP", "amount_including_tax": 5400, "tax_rate": 20, "display": "£54.00" },
  "starts_at": null,
  "all_day": false,
  "url": "https://acme.continuumlearn.com/learn/course/food-safety-level-2/preview",
  "buy_url": "https://acme.continuumlearn.com/buy/course/412",
  "slug": "food-safety-level-2",
  "visibility": "public",
  "in_person": false,
  "timezone": null,
  "requires_approval": false,
  "open_access": false,
  "capacity": { "spaces": 30, "remaining": 12 },
  "certificate_enabled": true,
  "cpd_hours": 3.5,
  "validity_months": 36,
  "prerequisite_ids": [398],
  "presenters": [{ "id": 7, "name": "Dr Jane Morgan" }],
  "available_languages": ["cy"],
  "created_at": "2026-03-02T09:15:00+00:00",
  "updated_at": "2026-11-09T14:05:51+00:00"
}
```

| Field | Description |
|---|---|
| `type` | `course`, `live` or `publication`. |
| `summary` | Plain text, at most 300 characters. |
| `image` | Image URL, or `null`. |
| `language` | The course's language code, or `null`. |
| `folders` | Ids of the course folders it is in. |
| `price` | `null` for a free course. Otherwise `amount` (net, in the currency's minor unit such as pence or cents, before VAT), `amount_including_tax` (in the minor unit, what the buyer pays), `tax_rate` (the VAT percentage applied to reach it: `0` for a zero-rated course, a team that is not VAT registered, or a team whose prices already include VAT), `currency` (the ISO 4217 code the course is sold in, such as `GBP`; it follows the team's selling currency) and `display`, which shows the VAT-inclusive price. |
| `starts_at` | For a dated course, its start. A course with a date but no time gives midnight in the course's timezone, with `all_day: true`. |
| `url` | The course page on your academy. |
| `buy_url` | Checkout for a paid course, otherwise `null`. |
| `visibility` | `public` (in your public catalogue) or `private`. |
| `requires_approval` | Learners who sign up need an administrator's approval. API enrolment skips it. |
| `open_access` | Anyone signed in to the team can take it without enrolling. |
| `capacity` | `spaces` and `remaining`, or both `null` when there's no limit. |
| `certificate_enabled`, `cpd_hours`, `validity_months` | Whether a certificate is issued, the CPD hours it carries, and how many months it is valid for. |
| `prerequisite_ids` | Courses that must be completed first. |
| `presenters` | The course's linked presenters. |
| `available_languages` | Languages the course has been translated into. |

## Get a course

`GET /courses/{id}` returns the same fields plus:

- `description_html`: the full description as sanitised HTML;
- `outline`: modules in order, each with its lessons (`id`, `title`, `order`, and `drip_release_at` when the lesson is released on a date).

```json
{
  "data": {
    "id": 412,
    "title": "Food Safety Level 2",
    "description_html": "<p>Everything food handlers need to know.</p>",
    "outline": [
      {
        "id": 1201,
        "title": "Hazards",
        "order": 1,
        "lessons": [
          { "id": 5301, "title": "Biological hazards", "order": 1, "drip_release_at": null }
        ]
      }
    ]
  }
}
```

Lesson content is never returned through the API. To show reading content on your own website, see [Website embeds](https://continuumlearn.com/developers/embeds).

## List course folders

`GET /course-folders` returns the team's folders. `translations` holds the folder name in other languages, when it has been translated.

```json
{
  "data": [
    { "id": 12, "name": "Food safety", "translations": { "cy": { "name": "Diogelwch bwyd" } }, "course_count": 8 }
  ],
  "meta": { "next_cursor": null, "has_more": false }
}
```

## List events

`GET /events` returns the team's published events: live events with one or more sessions, and on-demand recordings. By default it returns events that are live, upcoming, available as a replay or on demand. Pass `status=all` to include ended and expired events too. Because of that filter, a page can hold fewer than `limit` items: keep following `meta.next_cursor` while `has_more` is `true`.

```json
{
  "id": 88,
  "title": "Annual Conference 2026",
  "summary": "Two days of talks for members.",
  "image": "https://d3s1ce6myhihzg.cloudfront.net/...",
  "status": "upcoming",
  "type": "live",
  "next_session_start": "2026-12-03T09:30:00+00:00",
  "sessions_count": 4,
  "price": { "display": "£30.00", "from": true, "free": false, "currency": "GBP", "amount_including_tax": 3000, "tax_rate": 20 },
  "products": [
    { "id": 140, "name": "Member ticket", "price_display": "£30.00", "currency": "GBP", "amount_including_tax": 3000, "buy_url": "https://acme.continuumlearn.com/buy/broadcast_product/140" },
    { "id": 141, "name": "Non-member ticket", "price_display": "£72.00", "currency": "GBP", "amount_including_tax": 7200, "buy_url": "https://acme.continuumlearn.com/buy/broadcast_product/141" }
  ],
  "url": "https://acme.continuumlearn.com/watch/event/annual-conference-2026",
  "buy_url": "https://acme.continuumlearn.com/buy/broadcast_product/140"
}
```

| Field | Description |
|---|---|
| `type` | `live` (scheduled live sessions) or `vod` (a recording available on demand). |
| `status` | `live`, `upcoming`, `replay` or `available` (on demand). With `status=all`, also `ended`, `expired` and other finished states. |
| `next_session_start` | The next scheduled session, or `null`. |
| `price` | `null` when no ticket costs anything. `from: true` means there are several tickets and `display` is the cheapest; `free: true` means the cheapest is free. `display` includes VAT, `currency` is the ISO 4217 code of that price, `amount_including_tax` is that price in minor units (pence, cents) and `tax_rate` is the VAT percentage applied (the rate of the product shown). |
| `products` | The tickets on sale, each with its own checkout link and its own `currency` (an ISO 4217 code). Tickets are restamped when the team changes its selling currency, so it is the team's selling currency; only legacy rows in a third currency keep their own stamp. |
| `buy_url` | Checkout for the cheapest ticket, or `null`. |

`GET /events/{id}` returns one event in the same shape.

## Frequently asked questions

### Why do I see courses that aren't in my public catalogue?

The API returns private courses as well, with `visibility: private`, so you can enrol people on them. Filter with `?visibility=public` for what visitors can see.

### Are prices in pence?

`price.amount` is the net price in the currency's minor unit (pence, cents), before VAT. `price.amount_including_tax` is the VAT-inclusive price in the same unit, which is what checkout charges, and `price.display` shows that price ready to use, such as `£54.00`. Event tickets carry `amount_including_tax`, a VAT-inclusive `price_display` and a `currency` the same way. Amounts are in the minor unit of that `currency`.
