Skip to main content

Get Users

GET /admin/user_management.php
Retrieve a paginated list of users with filtering options.

Query Parameters

admin_id
integer
required
Administrator ID making the request
page
integer
default:"1"
Page number
per_page
integer
default:"20"
Number of users per page (max 100)
Search query (searches name, email, phone)
tipo_usuario
string
Filter by user type: pasajero, conductor, admin, empresa
es_activo
boolean
Filter by active status: 1 for active, 0 for inactive

Response

success
boolean
Request success status
usuarios
array
Array of user objects
pagination
object
Pagination metadata

Request Example

curl -X GET "https://76.13.114.194/admin/user_management.php?admin_id=1&page=1&per_page=20" \
  -H "Accept: application/json"

Response Example

Success
{
  "success": true,
  "usuarios": [
    {
      "id": 456,
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "nombre": "Carlos",
      "apellido": "Rodríguez",
      "email": "[email protected]",
      "telefono": "+573001234567",
      "tipo_usuario": "pasajero",
      "es_activo": true,
      "es_verificado": true,
      "creado_en": "2024-01-15T10:30:00.000Z",
      "calificacion": 4.8
    },
    {
      "id": 25,
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "nombre": "Juan",
      "apellido": "Martínez",
      "email": "[email protected]",
      "telefono": "+573109876543",
      "tipo_usuario": "conductor",
      "es_activo": true,
      "es_verificado": true,
      "empresa_id": 5,
      "creado_en": "2024-02-01T14:30:00.000Z",
      "calificacion": 4.9
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 156,
    "total_pages": 8
  }
}

Update User

PUT /admin/user_management.php
Update user information. Requires admin privileges.

Request Body

admin_id
integer
required
Administrator ID
user_id
integer
required
User ID to update
nombre
string
Updated first name
apellido
string
Updated last name
telefono
string
Updated phone number
tipo_usuario
string
Updated user type
es_activo
integer
Active status: 1 for active, 0 for inactive
es_verificado
integer
Verified status: 1 for verified, 0 for unverified
empresa_id
integer
Company ID for drivers

Response

success
boolean
Update success status
message
string
Success or error message

Request Example

curl -X PUT https://76.13.114.194/admin/user_management.php \
  -H "Content-Type: application/json" \
  -d '{
    "admin_id": 1,
    "user_id": 456,
    "es_activo": 0
  }'

Response Example

Success
{
  "success": true,
  "message": "Usuario actualizado exitosamente"
}

Delete User

DELETE /admin/user_management.php
Permanently delete a user account.

Request Body

admin_id
integer
required
Administrator ID
user_id
integer
required
User ID to delete

Response

success
boolean
Deletion success status
message
string
Confirmation message

Request Example

cURL
curl -X DELETE https://76.13.114.194/admin/user_management.php \
  -H "Content-Type: application/json" \
  -d '{
    "admin_id": 1,
    "user_id": 456
  }'
User deletion is permanent and cannot be undone. Consider deactivating users instead of deleting them.

Suspend User

POST /admin/suspender_usuario.php
Temporarily suspend a user account.

Request Body

user_id
integer
required
User ID to suspend
motivo
string
required
Reason for suspension

Request Example

cURL
curl -X POST https://76.13.114.194/admin/suspender_usuario.php \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": 456,
    "motivo": "Violación de términos de servicio"
  }'

Activate User

POST /admin/activar_usuario.php
Reactivate a suspended user account.

Request Body

user_id
integer
required
User ID to activate

Request Example

cURL
curl -X POST https://76.13.114.194/admin/activar_usuario.php \
  -H "Content-Type: application/json" \
  -d '{"user_id": 456}'

Error Responses

400
Bad Request
Invalid parameters or missing required fields
403
Forbidden
Insufficient admin privileges
404
Not Found
User not found
500
Internal Server Error
Server error during operation

See Also

Build docs developers (and LLMs) love