Appearance
Listar invitaciones recibidas
GET
/invitations
Obtiene la lista de invitaciones recibidas para el usuario autenticado.
Casos de uso:
- Consultar invitaciones pendientes de aceptar
- Revisar historial de invitaciones recibidas
- Gestionar invitaciones por estado (pendiente, aceptada, rechazada)
Authorizations
bearerAuth
JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.
TypeHTTP (bearer)
Parameters
Query Parameters
status
Filtrar por estado de invitación
Typestring
Enum
pendingacceptedrejectedExample
pendingpage
Número de página para paginación
Typeinteger
Example
1minimum
1default
1limit
Cantidad de elementos por página
Typeinteger
Example
20minimum
1maximum
100default
20Responses
Lista de invitaciones obtenida exitosamente
application/json
JSON
{
"success": true,
"message": "Invitations retrieved successfully",
"data": {
"invitations": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "string",
"sender": {
"entity_id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Empresa ABC S.A.S."
},
"credit": {
"credit_id": "789e0123-e45f-6768-a901-234567890123",
"amount": 5000000,
"currency": "COP"
},
"phone": "+57 300 123 4567",
"method": "string",
"created_at": "2024-01-16T14:20:00Z",
"expires_at": "2024-02-15T14:20:00Z"
}
],
"pagination": {
"current_page": 1,
"total_pages": 3,
"total_items": 45,
"items_per_page": 20
}
}
}