Tasks General Report

Individual task records with status timeline and assignment details.

GET/apidev/v1/reports/gt/tasks-general

PermissionAPICLI_RPTGT_TAREAS

Rate Limit10 req/min

Cache300s

Max Range31 days

---

Request

Query Parameters

Parameter	Type	Required	Default	Description
startdate	string	Yes	—	ISO 8601 start date-time (e.g. 2026-03-01T00:00:00).
enddate	string	Yes	—	ISO 8601 end date-time. Max range 31 days from startdate.
devices	string	No	—	Comma-separated device IDs. Max 500.
drivers	string	No	—	Comma-separated driver IDs. Max 500.
statuses	string	No	—	Comma-separated status codes. Max 50.
service_type_id	string	No	—	Single service type ID.
cause_id	string	No	—	Single cause ID.
date_type	enum	No	created	Date field to filter by: created, scheduled, finished.
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

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/gt/tasks-general?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&date_type=created&limit=25"

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/tasks-general?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&date_type=created&limit=25`,
  {
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'X-API-Key': APIKEY,
      'tenant': TENANT,
    },
  }
);
const data = await res.json();

Python

import requests

response = requests.get(
    f"https://{TENANT}/apidev/v1/reports/gt/tasks-general",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"startdate": "2026-03-01T00:00:00", "enddate": "2026-03-15T23:59:59", "date_type": "created", "limit": 25},
)
data = response.json()

---

Response

Response Fields

Field	Type	Description
task_id	string | null	Task identifier.
created_at	string | null	Task creation timestamp.
scheduled_at	string | null	Scheduled timestamp.
accepted_at	string | null	Accepted timestamp.
started_at	string | null	Started timestamp.
finished_at	string | null	Finished timestamp.
device_name	string	Assigned vehicle.
driver_name	string	Assigned driver.
statuses	array	Status history entries.

Example Response

{
  "success": true,
  "data": [
    {
      "task_id": "104820580001",
      "created_at": "2026-03-05T08:15:00",
      "scheduled_at": "2026-03-05T09:00:00",
      "accepted_at": "2026-03-05T08:22:00",
      "started_at": "2026-03-05T09:05:00",
      "finished_at": "2026-03-05T10:30:00",
      "device_name": "Truck A-101",
      "driver_name": "Carlos Martinez",
      "statuses": [
        {"status": "ASI", "datetime": "2026-03-05T08:15:00"},
        {"status": "ACE", "datetime": "2026-03-05T08:22:00"},
        {"status": "FIN", "datetime": "2026-03-05T10:30:00"}
      ]
    }
  ],
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
BAD_REQUEST	400	Missing required headers.
VALIDATION_ERROR	400	Invalid params: missing dates, range > 31 days, 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.

---

Related

• Productivity Report
• Rejected Tasks Report
• Proactivity by Task Report
• Pagination