GET
/users/v2/{id}/block-eventsListar eventos de bloqueo
El endpoint /users/v2/{id}/block-events te permite consultar el historial de eventos de bloqueo y desbloqueo de un usuario.
Consideraciones
Cada vez que un usuario es bloqueado o desbloqueado se genera un evento. Este endpoint devuelve la lista de eventos ordenada de más reciente a más antiguo.
Los resultados son paginados. Podés controlar la paginación con los parámetros:
limit: cantidad de resultados por página. Valor por defecto: 25. Máximo: 100.offset: posición desde la que empezar. Valor por defecto: 0.
Campos del evento
| Campo | Descripción |
|---|---|
id | Identificador del evento |
user_id | ID del usuario |
event_type | BLOCK o UNBLOCK |
reason | Razón del bloqueo o desbloqueo |
comment | Comentario adicional (puede estar oculto según permisos) |
actor_email | Email del actor que realizó la acción |
actor_area | Área del actor |
created_at | Fecha y hora del evento en formato ISO 8601 |
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
Path Parameters
idStringrequired
Query Parameters
limitInteger
offsetInteger
Detalle de respuestas
400
Request inválido
401
No autorizado
403
Acceso denegado
Ejemplo de código
curl -X GET "https://api.pomelo.la/users/v2/example_value/block-events?limit=25&offset=0" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY"Ejemplo de respuesta (200)Eventos de bloqueo del usuario
{
"data": [
{
"id": "evt-01HXYZ...",
"user_id": "usr-203c6jQq0O3nVWXj6jRUQXy7QkC",
"event_type": "BLOCK",
"reason": "CLIENT_INTERNAL_REASON",
"comment": "Bloqueado por actividad sospechosa",
"actor_email": "[email protected]",
"actor_area": "compliance",
"client_id": "client-abc",
"created_at": "2026-01-15T10:30:00Z"
}
]
}