Actividades de Tarea
Listar Actividades de Tarea
Obtener una lista paginada de actividades TASK con filtros de ruta/operador.
GET /api/activities/tasks
Devuelve una lista paginada de actividades de tipo TASK con filtros adicionales de ruta y operador.
Auth: Requerida — permiso VIEW_ACTIVITIES
Parámetros de Consulta
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
page | number | 1 | Número de página |
per_page | number | 25 | Elementos por página (máx. 100) |
search | string | - | Buscar actividades de tarea |
status | string | - | Filtrar por estado de actividad |
channel | string | - | Filtrar por canal |
commerce_id | UUID | - | Filtrar por comercio |
assigned_route_id | UUID | - | Filtrar por ruta asignada |
assigned_operator_id | UUID | - | Filtrar por operador asignado |
scheduled_from | ISO 8601 | - | Filtrar desde fecha programada |
scheduled_to | ISO 8601 | - | Filtrar hasta fecha programada |
result_status | string | - | Filtrar por estado del último resultado |
Ejemplo
curl "https://api.reten.ai/api/activities/tasks?routeId=<routeId>&status=READY" \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>"const params = new URLSearchParams({ assigned_route_id: "<routeId>", status: "READY" });
const response = await fetch(`https://api.reten.ai/api/activities/tasks?${params}`, {
headers: {
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
});
const data = await response.json();import requests
response = requests.get(
"https://api.reten.ai/api/activities/tasks",
headers={
"Authorization": "Bearer <token>",
"x-tenant-id": "<tenant-id>",
},
params={"assigned_route_id": "<routeId>", "status": "READY"},
)
data = response.json()Respuesta 200 OK
{
"data": [
{
"id": "ee0e8400-e29b-41d4-a716-446655440000",
"type": "TASK",
"channel": "SALESMAN",
"status": "READY",
"taskDetails": {
"assignedRouteId": "dd0e8400-e29b-41d4-a716-446655440000",
"assignedOperatorId": "cc0e8400-e29b-41d4-a716-446655440000",
"route": { "name": "North Zone" },
"operator": { "firstName": "John", "lastName": "Doe" }
},
"commerceAssignment": {
"commerce": { "name": "Main Street Store" }
}
}
],
"meta": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}