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	Internal task identifier (Snowflake). Not the number shown on screen — see service_number.
service_number	string | null	Task number as displayed to operators and customers.
assistance_number	string	Assistance number.
account_name	string	Account name.
account_external_code	string	Account unique/external code.
client_name	string	Client name.
status_name	string	Current task status, already resolved to its human label.
cause_name	string	Origin cause.
contact	string	Task contact person.
route_name	string	Assigned route.
communication_channel	string	Communication template / channel used to create the task.
completion_code	string	Completion (end-of-service) code.
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. Empty by default: the status-detail columns are turned off in the web report and the underlying subquery is expensive, so it is not requested.

Task identifiers

task_id is the internal Snowflake ID; service_number is the number your operators and customers actually use. Reconcile against the web report with service_number.

Example Response

{
  "success": true,
  "data": [
    {
      "task_id": "104820580001",
      "service_number": "55012",
      "assistance_number": "A-7734",
      "account_name": "Logistica Sur S.A.",
      "account_external_code": "EXT-9912",
      "client_name": "Seguros del Plata",
      "status_name": "Finished",
      "cause_name": "Breakdown",
      "contact": "Ana Perez",
      "route_name": "North Route",
      "communication_channel": "Web",
      "completion_code": "Resolved on site",
      "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": []
    }
  ],
  "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