Catalogue - courses, folders and events

View as Markdown

In short

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, 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.
curl "https://your-team.continuumlearn.com/api/v2/courses?visibility=public&folder=12" \
  -H "Authorization: Bearer $CONTINUUM_API_KEY"

Each course:

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

List course folders

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

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

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

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.