Get Courses participants

GET /v1/courses/{courseId}/participants

Get Courses participants

Path parameters

  • courseId string Required

    The id of the course

Query parameters

  • page integer | null

    The page number in a paginated set of results

  • limit integer | null

    The limit of results to be returned per page

  • firstname[in] array[string]

    The firstnames of spot member to include in the result

  • lastname[in] array[string]

    The lastnames of spot member to include in the result

  • email[in] array[string]

    The emails of spot member to include in the result

  • status[eq] string

    Search participants with a specific status

    Values are Invited, Started, Completed, or Unenrolled.

  • status[in] array[string]

    Search participants with one of theses status

    Values are Invited, Started, Completed, or Unenrolled.

Responses

  • 200 application/json

    Courses participants returned successfully

    Hide response attributes Show response attributes object
    • items array[object] Required

      The items found

      Hide items attributes Show items attributes object
      • id string Required

        The id of the course participant.

      • courseId string Required

        The id of the course.

      • spotMemberId string Required

        The ID of the Spot member associated to the participant

      • spotMemberEmail string Required

        The email of the Spot member associated to the participant

      • spotMemberFirstname object | null Required

        The Spot member firstname associated to the participant. Can be null for a participant invited by email.

      • spotMemberLastname object | null Required

        The Spot member lastname associated to the participant. Can be null for a participant invited by email.

      • status string Required

        The status of the course participant.

        Values are Invited, Started, Completed, or Unenrolled.

      • invitedAt string(date-time) | null Required

        The invitation date of the participant.

      • startedAt string(date-time) | null Required

        The start date of the participant.

      • completedAt string(date-time) | null Required

        The completion date of the participant.

      • unenrolledAt string(date-time) | null Required

        The unenrollment date of the participant.

      • lastActivityAt string(date-time) | null Required

        The last activity date of the participant.

      • completionRate integer Required

        The completion rate of the participant.

    • total integer Required

      The total number of items found

  • 400

    Malformed payload

  • 404

    Course not found

GET /v1/courses/{courseId}/participants
curl \
 --request GET 'https://openapi.meltingspot.io/v1/courses/{courseId}/participants'
Response examples (200)
{
  "items": [
    {
      "id": "string",
      "courseId": "string",
      "spotMemberId": "string",
      "spotMemberEmail": "string",
      "spotMemberFirstname": {},
      "spotMemberLastname": {},
      "status": "Invited",
      "invitedAt": "2025-05-04T09:42:00Z",
      "startedAt": "2025-05-04T09:42:00Z",
      "completedAt": "2025-05-04T09:42:00Z",
      "unenrolledAt": "2025-05-04T09:42:00Z",
      "lastActivityAt": "2025-05-04T09:42:00Z",
      "completionRate": 42
    }
  ],
  "total": 42
}