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

---

Overview

Returns individual task records over a date range, each with its full status timeline (assigned, accepted, started, finished) plus the assigned vehicle and driver. Filter by devices, drivers, status codes, service type, or cause, and choose which date field (created, scheduled, or finished) the range applies to.

---

Request

Request Headers

Every request to a protected endpoint requires these headers:

Header	Required	Description
Authorization	Yes	Bearer token obtained from the Login endpoint. Format: Bearer <token>
X-API-Key	Yes	Company integration key provided during onboarding. Format: gtk_xxx...
tenant	Yes	Your assigned tenant domain (default: geotareas.com) — always send your assigned tenant
Content-Type	Conditional	application/json — required for POST and PUT requests

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
VALIDATION_ERROR	400	Invalid params: missing dates, range > 31 days, invalid enum values.
UNAUTHORIZED	401	Missing, invalid, or expired tenant / Authorization / X-API-Key
FORBIDDEN	403	User lacks required permission.
RATE_LIMITED	429	Exceeded 10 req/min.
INTERNAL_ERROR	500	Unexpected server error.

---

Related

• Rejected Tasks Report
• Pagination