List appointments for a course

Returns appointments linked to the course identified by course entity id (the id field from GET /courses, not layerId). Response items omit participants, creator, user groups, and series — see CourseAppointmentListItem.

GET/courses/{id}/appointments

Authorization

AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Path parameters

idstringrequired

Course entity ID (id from GET /courses).

Query parameters

cursorstring

limitinteger

min 1 · max 100 · default: 10

Responses

200

Paginated list of appointments for the course

dataCourseAppointmentListItem[]required

Show properties

Array of CourseAppointmentListItem

idstringrequired

titlestringrequired

notesstring

dateTimestring<date-time>required

durationintegerrequired

isOnlinebooleanrequired

isHybridbooleanrequired

onlineAddressstring

addressstring

locationstring | null

providerstring

appointmentLayersAppointmentLayer[]

Show properties

Array of AppointmentLayer

layerIdstring

layerobject | null

Show properties

idstring

namestring

courseobject | null

Show properties

idstring

Course entity ID

codestring | null

namestring

appointmentRoomsAppointmentRoomBooking[]

Show properties

Array of AppointmentRoomBooking

roomIdstring

setupIdstring | null

roomobject

setupobject | null

organizerUsersAppointmentOrganizer[]

Show properties

Array of AppointmentOrganizer

organizerIdstringrequired

appointmentTypeobject | null

paginationCursorPaginationrequired

Show properties

next_cursorstring | nullrequired

has_morebooleanrequired

limitintegerrequired

metaResponseMetarequired

Show properties

requestIdstringrequired

timestampstring<date-time>required

versionstringrequired

Allowed:v4

401

Unauthorized

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

403

Forbidden

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

404

Not Found

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

429

Too Many Requests

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

500

Internal Server Error

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Basic auth usernameBasic auth password

Remember on this deviceInclude my values in samples

Parameters

idpath*Course entity ID (`id` from `GET /courses`).cursorquerylimitquery

Request

curl -X GET 'https://fuxam.app/api/v4/courses/clx1234567890/appointments' \
  -H 'Authorization: Basic YOUR_CREDENTIALS'

const response = await fetch("https://fuxam.app/api/v4/courses/clx1234567890/appointments", {
  method: "GET",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS"
  }
});

import requests

response = requests.get(
    "https://fuxam.app/api/v4/courses/clx1234567890/appointments",
    headers={
        "Authorization": "Basic YOUR_CREDENTIALS"
    },
)

Response

{
  "data": [
    {
      "id": "appt_def456",
      "title": "Introduction lecture",
      "notes": "First session of the semester",
      "dateTime": "2026-09-15T10:00:00.000Z",
      "duration": 90,
      "isOnline": false,
      "isHybrid": false,
      "onlineAddress": "",
      "address": "Building A, Room 101",
      "location": null,
      "provider": "fuxam",
      "appointmentLayers": [
        {
          "layerId": "layer_abc123",
          "layer": {
            "id": "layer_abc123",
            "name": "CS101"
          },
          "course": {
            "id": "clx1234567890",
            "code": "CS101",
            "name": "Introduction to Computer Science"
          }
        }
      ],
      "appointmentRooms": [],
      "organizerUsers": [
        {
          "organizerId": "user_organizer1"
        }
      ],
      "appointmentType": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 10
  },
  "meta": {
    "requestId": "req_1782305464335_hqnbhdhoaer",
    "timestamp": "2026-06-24T12:51:04.381Z",
    "version": "v4"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}