Read one enrollment's attendance

GET /api/v1/live-sessions/{liveSessionId}/attendance/{enrollmentId}

Returns the attendance recorded for one enrollment at a live session, in the same shape as the recording response. It answers 404 while nothing has been recorded: no attendance is not an implicit absence.

Authorization

Organization role

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Refused — `403`

Business authorization

Requirement	Rule for this endpoint
Business role	None
Resource scope	Live session of the key's organization
Participation	None
Resource state	An attendance has been recorded for this enrollment

Path parameters

Parameter	Type	Required	Description
`liveSessionId`	UUID	yes	Live session of the key's organization
`enrollmentId`	UUID	yes	Enrollment whose attendance you read

Request headers

Header	Required	Description
`x-api-key`	yes	API key created for this organization
`X-Correlation-Id`	no	Caller correlation id, returned or generated

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/live-sessions/$LIVE_SESSION_ID/attendance/$ENROLLMENT_ID" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the recorded attendance.
401 Unauthorized — missing, unknown or expired key; code is unauthorized.
403 Forbidden — the bearer is not OWNER or ADMIN; code is forbidden.
404 Not Found — nothing is recorded for this enrollment, or the live session is unknown or belongs to another organization; code is not_found.

Response fields

Field	Type	Nullable	Description
`success`	boolean	no	`true` for a successful request
`data.enrollmentId`	UUID	no	Enrollment
`data.liveSessionId`	UUID	no	Live session
`data.status`	string	no	`attended`, `absent`, `excused` or `unknown`
`data.reason`	string	yes	Reason recorded with the current value
`data.recordedByUserId`	UUID	no	Account that recorded the current value
`data.updatedAt`	ISO 8601 string	no	When the current value was recorded, in UTC
`correlationId`	UUID	no	Correlation id for support

Example response

json

{
  "success": true,
  "data": {
    "enrollmentId": "4af4cd8d-0000-4000-8000-000000000000",
    "liveSessionId": "b27c6e05-0000-4000-8000-000000000000",
    "status": "excused",
    "reason": "Medical appointment, notified the day before",
    "recordedByUserId": "6d41ab55-0000-4000-8000-000000000000",
    "updatedAt": "2026-09-25T18:02:11.000Z"
  },
  "correlationId": "7a2c9e14-0000-4000-8000-000000000000"
}

Notes

To see who is still unrecorded, use the list: it returns every targeted enrollment, unknown included.
An explicitly recorded unknown answers 200; only the absence of any record answers 404.

GET /api/v1/live-sessions/{liveSessionId}/attendance/{enrollmentId}

Authorization

Organization role

Role in the organization	This endpoint
`OWNER`	Allowed
`ADMIN`	Allowed
`MEMBER`	Refused — `403`

Business authorization

Requirement	Rule for this endpoint
Business role	None
Resource scope	Live session of the key's organization
Participation	None
Resource state	An attendance has been recorded for this enrollment

Path parameters

Parameter	Type	Required	Description
`liveSessionId`	UUID	yes	Live session of the key's organization
`enrollmentId`	UUID	yes	Enrollment whose attendance you read

Request headers

Header	Required	Description
`x-api-key`	yes	API key created for this organization
`X-Correlation-Id`	no	Caller correlation id, returned or generated

Example

bash

curl "$COHORTE_API_BASE_URL/api/v1/live-sessions/$LIVE_SESSION_ID/attendance/$ENROLLMENT_ID" \
  -H "x-api-key: $COHORTE_API_KEY"

Response

200 OK — the recorded attendance.
401 Unauthorized — missing, unknown or expired key; code is unauthorized.
403 Forbidden — the bearer is not OWNER or ADMIN; code is forbidden.
404 Not Found — nothing is recorded for this enrollment, or the live session is unknown or belongs to another organization; code is not_found.

Response fields

Field	Type	Nullable	Description
`success`	boolean	no	`true` for a successful request
`data.enrollmentId`	UUID	no	Enrollment
`data.liveSessionId`	UUID	no	Live session
`data.status`	string	no	`attended`, `absent`, `excused` or `unknown`
`data.reason`	string	yes	Reason recorded with the current value
`data.recordedByUserId`	UUID	no	Account that recorded the current value
`data.updatedAt`	ISO 8601 string	no	When the current value was recorded, in UTC
`correlationId`	UUID	no	Correlation id for support

Example response

json

{
  "success": true,
  "data": {
    "enrollmentId": "4af4cd8d-0000-4000-8000-000000000000",
    "liveSessionId": "b27c6e05-0000-4000-8000-000000000000",
    "status": "excused",
    "reason": "Medical appointment, notified the day before",
    "recordedByUserId": "6d41ab55-0000-4000-8000-000000000000",
    "updatedAt": "2026-09-25T18:02:11.000Z"
  },
  "correlationId": "7a2c9e14-0000-4000-8000-000000000000"
}

Notes

To see who is still unrecorded, use the list: it returns every targeted enrollment, unknown included.
An explicitly recorded unknown answers 200; only the absence of any record answers 404.

Read one enrollment's attendance

Read one enrollment's attendance

Authorization

Organization role

Business authorization

Path parameters

Request headers

Example

Response

Response fields

Example response

Notes

Related

Authorization

Organization role

Business authorization

Path parameters

Request headers

Example

Response

Response fields

Example response

Notes

Related