Skip to main content
Attendance records represent a user’s participation status for a specific event. When a user registers for an event, an attendance entry is created linking their account to that event with a state of CONFIRMADO, PENDIENTE, or CANCELADO.

​
Attendance states

StateMeaning
CONFIRMADOThe user has confirmed they will attend.
PENDIENTEThe user has expressed interest but not yet confirmed.
CANCELADOThe user has cancelled their attendance.

​
Attendance fields

The AttendanceDto returned by the API contains the following fields.
FieldTypeDescription
idGuidUnique identifier for the attendance record.
userIdstringID of the attending user.
userNamestringDisplay name of the attending user.
userMembershipMembershipDtoActive membership of the user, if any.
eventIdGuidID of the event being attended.
eventTitlestringTitle of the event.
statestringCurrent attendance state (CONFIRMADO, PENDIENTE, or CANCELADO).

​
Registering for an event

1

Authenticate

Obtain a Bearer token by signing in. The POST /api/attendances endpoint requires the User, Organizer, or Admin role.
2

Choose a state

Decide your initial attendance state. Use CONFIRMADO if you are certain you will attend, or PENDIENTE if you are still deciding.
3

Submit the attendance record

Send a POST request to /api/attendances with your user ID, the event ID, and the chosen state.
POST /api/attendances

{
  "userId": "user-id-string",
  "eventId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "state": "CONFIRMADO"
}
A successful response returns the newly created AttendanceDto.
4

Update your state if needed

If your plans change, update your attendance state with a PUT request.
PUT /api/attendances/{id}

{
  "state": "CANCELADO"
}

​
Cancelling attendance

To cancel your registration, either update the state to CANCELADO via PUT /api/attendances/{id}, or delete the record entirely. 
DELETE /api/attendances/{id}
Deleting an attendance record removes it entirely. Updating the state to CANCELADO keeps the record for tracking purposes.

​
Browsing attendances

The list endpoint is publicly accessible and supports search and pagination. 
GET /api/attendances?searchTerm=&page=1
The event detail endpoint (GET /api/events/{id}) also includes the full attendance list and a total count in attendancesCount, which can be used to track event capacity.

Build docs developers (and LLMs) love

Get started for freeTalk to us