Proactivity by Task Report

Task-level compliance detail for a specific execution date — summary + individual task records.

GET/apidev/v1/reports/gt/proactivity-task

PermissionAPICLI_RPTGT_PROACTIVIDAD_TAREA

Rate Limit10 req/min

Cache60s (1 min)

Request

Query Parameters

Parameter	Type	Required	Default	Description
`execution_date`	string	Yes	—	ISO 8601 date (e.g. `2026-03-19`). Single date, not a range.
`realtime`	boolean	No	—	Include real-time data.
`devices`	string	No	—	Comma-separated device IDs. Max 500.
`drivers`	string	No	—	Comma-separated driver IDs. Max 500.
`service_types`	string	No	—	Comma-separated service type IDs. Max 100.
`causes`	string	No	—	Comma-separated cause IDs. Max 100.
`subcauses`	string	No	—	Comma-separated subcause IDs. Max 100.
`countries`	string	No	—	Comma-separated country IDs. Max 50.
`departments`	string	No	—	Comma-separated department IDs. Max 50.
`geofences`	string	No	—	Comma-separated geofence IDs. Max 100.
`limit`	integer	No	`25`	Number of records per page (`1`–`100`).
`offset`	integer	No	`0`	Number of records to skip for pagination.

Code Examples

cURL
JavaScript
Python

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/gt/proactivity-task?execution_date=2026-03-19&limit=25"

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/proactivity-task?execution_date=2026-03-19&limit=25`,
  {
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'X-API-Key': APIKEY,
      'tenant': TENANT,
    },
  }
);
const data = await res.json();

import requests

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/gt/proactivity-task",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"execution_date": "2026-03-19", "limit": 25},
)
data = response.json()

Response

The data field contains summary and tasks objects instead of a flat array.

Summary Fields

Field	Type	Description
`total_devices`	number	Total devices with activity.
`total_tasks`	number	Total task count.
`tasks_finished`	number	Finished tasks.
`tasks_pending`	number	Pending tasks.
`tasks_in_progress`	number	In-progress tasks.
`tasks_cancelled`	number	Cancelled tasks.
`compliance_pct`	number	Compliance percentage.

Tasks Array Fields

Field	Type	Description
`task_number`	string \| null	Task number.
`device_name`	string	Vehicle name.
`driver_name`	string	Driver name.
`service_type`	string	Service type.
`cause`	string	Cause name.
`status`	string	Task status code.
`scheduled_at`	string \| null	Scheduled timestamp.
`started_at`	string \| null	Started timestamp.
`finished_at`	string \| null	Finished timestamp.
`client_name`	string	Client name.
`account_name`	string	Account name.

Example Response

{
  "success": true,
  "data": {
    "summary": {
      "total_devices": 5,
      "total_tasks": 47,
      "tasks_finished": 35,
      "tasks_pending": 8,
      "tasks_in_progress": 3,
      "tasks_cancelled": 1,
      "compliance_pct": 74.47
    },
    "tasks": [
      {
        "task_number": "104820580001",
        "device_name": "Truck A-101",
        "driver_name": "Carlos Martinez",
        "service_type": "Maintenance",
        "cause": "Scheduled",
        "status": "FIN",
        "scheduled_at": "2026-03-05T09:00:00",
        "started_at": "2026-03-05T09:05:00",
        "finished_at": "2026-03-05T10:30:00",
        "client_name": "Client Corp",
        "account_name": "Account Alpha"
      }
    ]
  },
  "meta": {
    "total": 47,
    "limit": 25,
    "offset": 0
  }
}

Errors

Code	HTTP	Description
`BAD_REQUEST`	400	Missing required headers.
`VALIDATION_ERROR`	400	Invalid params: missing `execution_date`, invalid enum values.
`UNAUTHORIZED`	401	Invalid or expired JWT / API Key.
`FORBIDDEN`	403	User lacks required permission.
`RATE_LIMITED`	429	Exceeded 10 req/min.
`INTERNAL_ERROR`	500	Unexpected server error.

Request​

Query Parameters​

Code Examples​

Response​

Summary Fields​

Tasks Array Fields​

Example Response​

Errors​

Related​