Overview
The Inscritos API allows you to manage registered participants in the MTB Backend system. Each inscrito represents a confirmed participant with their details, age, category, and registration type.
This endpoint supports draft and publish functionality. Use the publishedAt field to control publication status.
List All Inscritos
Retrieve a list of all registered participants with optional filtering, sorting, and pagination.
Query Parameters
Filter participants by field values. Example: filters[categoria][$eq]=Elite
Sort participants by field(s). Example: nombreCompleto:asc
Page number for pagination
Response
Array of inscrito objects Unique identifier for the participant
Full name of the participant
Chilean national ID (RUT) of the participant
Age of the participant (between 3 and 99)
Competition category: Infantil, Experto, Enduro, Elite, Master A, or Master B
Registration type: Open or Federado
Publication timestamp (null if draft)
Pagination metadata Total number of participants
Example Request
curl -X GET "https://api.example.com/api/inscritos?filters[categoria][ $eq ]=Elite&sort=nombreCompleto:asc" \
-H "Content-Type: application/json"
Example Response
{
"data" : [
{
"id" : 1 ,
"attributes" : {
"nombreCompleto" : "Diego Fernández" ,
"rut" : "11223344-5" ,
"edad" : 32 ,
"categoria" : "Elite" ,
"tipo" : "Federado" ,
"publishedAt" : "2024-01-20T10:00:00.000Z" ,
"createdAt" : "2024-01-20T10:00:00.000Z" ,
"updatedAt" : "2024-01-20T10:00:00.000Z"
}
}
],
"meta" : {
"pagination" : {
"page" : 1 ,
"pageSize" : 25 ,
"pageCount" : 1 ,
"total" : 1
}
}
}
Get a Single Inscrito
Retrieve a specific registered participant by their ID.
Path Parameters
The unique identifier of the participant
Response
The inscrito object (see List All Inscritos for structure)
Example Request
curl -X GET "https://api.example.com/api/inscritos/1" \
-H "Content-Type: application/json"
Example Response
{
"data" : {
"id" : 1 ,
"attributes" : {
"nombreCompleto" : "Diego Fernández" ,
"rut" : "11223344-5" ,
"edad" : 32 ,
"categoria" : "Elite" ,
"tipo" : "Federado" ,
"publishedAt" : "2024-01-20T10:00:00.000Z" ,
"createdAt" : "2024-01-20T10:00:00.000Z" ,
"updatedAt" : "2024-01-20T10:00:00.000Z"
}
}
}
Create an Inscrito
Create a new registered participant entry.
Request Body
Full name of the participant
Chilean national ID (RUT) of the participant
Age of the participant (must be between 3 and 99)
Competition category. Must be one of: Infantil, Experto, Enduro, Elite, Master A, Master B
Registration type. Must be one of: Open, Federado
Response
The created inscrito object
Example Request
curl -X POST "https://api.example.com/api/inscritos" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"data": {
"nombreCompleto": "Laura Rojas",
"rut": "55667788-9",
"edad": 27,
"categoria": "Experto",
"tipo": "Open"
}
}'
Example Response
{
"data" : {
"id" : 2 ,
"attributes" : {
"nombreCompleto" : "Laura Rojas" ,
"rut" : "55667788-9" ,
"edad" : 27 ,
"categoria" : "Experto" ,
"tipo" : "Open" ,
"publishedAt" : null ,
"createdAt" : "2024-01-25T10:00:00.000Z" ,
"updatedAt" : "2024-01-25T10:00:00.000Z"
}
}
}
Update an Inscrito
Update an existing registered participant by their ID.
Path Parameters
The unique identifier of the participant to update
Request Body
Inscrito fields to update (same structure as Create)
Response
The updated inscrito object
Example Request
curl -X PUT "https://api.example.com/api/inscritos/2" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
-d '{
"data": {
"categoria": "Elite",
"tipo": "Federado"
}
}'
Example Response
{
"data" : {
"id" : 2 ,
"attributes" : {
"nombreCompleto" : "Laura Rojas" ,
"rut" : "55667788-9" ,
"edad" : 27 ,
"categoria" : "Elite" ,
"tipo" : "Federado" ,
"publishedAt" : null ,
"createdAt" : "2024-01-25T10:00:00.000Z" ,
"updatedAt" : "2024-01-25T11:00:00.000Z"
}
}
}
Delete an Inscrito
Delete a registered participant by their ID.
Path Parameters
The unique identifier of the participant to delete
Response
The deleted inscrito object
Example Request
curl -X DELETE "https://api.example.com/api/inscritos/2" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN"
Example Response
{
"data" : {
"id" : 2 ,
"attributes" : {
"nombreCompleto" : "Laura Rojas" ,
"rut" : "55667788-9" ,
"edad" : 27 ,
"categoria" : "Elite" ,
"tipo" : "Federado" ,
"publishedAt" : null ,
"createdAt" : "2024-01-25T10:00:00.000Z" ,
"updatedAt" : "2024-01-25T11:00:00.000Z"
}
}
}
Important: Deleting a participant record is permanent and cannot be undone. Ensure you have proper backups before performing delete operations.
Categories and Types
Available Categories
The categoria field must be one of the following values:
Infantil : Children’s category
Experto : Expert level riders
Enduro : Enduro discipline
Elite : Elite professional level
Master A : Master category A
Master B : Master category B
Available Types
The tipo field must be one of the following values:
Open : Open registration for all participants
Federado : Federated/official club members only
Age Validation
The edad field must be between 3 and 99 years old.