Skip to main content
GET
/
api
/
Rol
/
Lista
List Roles
curl --request GET \
  --url https://api.example.com/api/Rol/Lista
{
  "status": true,
  "value": [
    {
      "idRol": 123,
      "nombre": "<string>"
    }
  ],
  "msg": "<string>"
}
Retrieves a list of all available roles in the system.

​
Endpoint

GET /api/Rol/Lista

​
Response

Returns an array of roles available in the system.
​
status
boolean
required
Indicates if the request was successful
​
value
array
List of roles
​
msg
string
Error message if status is false

​
Example Request

curl -X GET "https://api.example.com/api/Rol/Lista" \
  -H "Content-Type: application/json"

​
Example Response

{
  "status": true,
  "value": [
    {
      "idRol": 1,
      "nombre": "Administrador"
    },
    {
      "idRol": 2,
      "nombre": "Empleado"
    },
    {
      "idRol": 3,
      "nombre": "Supervisor"
    }
  ],
  "msg": null
}

​
Error Response

{
  "status": false,
  "value": null,
  "msg": "Error retrieving roles list"
}

​
Use Cases

  • Populate role dropdowns in user management interfaces
  • Display available roles during user registration
  • Role assignment and permission management

Build docs developers (and LLMs) love

Get started for freeTalk to us