Task Activities
List Task Activities
Get a paginated list of TASK activities with route/operator filters.
GET /api/activities/tasks
Returns a paginated list of TASK-type activities with additional route and operator filters.
Auth: Required — VIEW_ACTIVITIES permission
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page | number | 1 | Page number |
per_page | number | 25 | Items per page (max 100) |
search | string | - | Search task activities |
status | string | - | Filter by activity status |
channel | string | - | Filter by channel |
commerce_id | UUID | - | Filter by commerce |
assigned_route_id | UUID | - | Filter by assigned route |
assigned_operator_id | UUID | - | Filter by assigned operator |
scheduled_from | ISO 8601 | - | Filter from scheduled date |
scheduled_to | ISO 8601 | - | Filter to scheduled date |
result_status | string | - | Filter by latest result status |
Example
curl "https://api.reten.ai/api/activities/tasks?routeId=<routeId>&status=READY" \
-H "Authorization: Bearer <token>" \
-H "x-tenant-id: <tenant-id>"import axios from 'axios';
const response = await axios.get(
'https://api.reten.ai/api/activities/tasks',
{
params: { routeId: '<routeId>', status: 'READY' },
headers: {
Authorization: 'Bearer <token>',
'x-tenant-id': '<tenant-id>',
},
}
);
const { data, meta } = response.data;Response 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
}
}