Revisits Report

Detects repeat visits to the same account within a configurable window — revisit rate and first-time-fix rate per group.

GET/apidev/v1/reports/gt/revisits

PermissionAPICLI_RPTGT_REVISITAS

Rate Limit10 req/min

Cache300s

Max Range92 days

---

Overview

Identifies when the same account was visited more than once within a short period — a signal that the first visit did not resolve the problem. For each finished task, the report looks at the previous finished task on the same account; if the gap is within the revisit window, the task is counted as a revisit, otherwise as a first visit. Results are aggregated per group with the revisit rate, the first-time-fix rate, and the average days between consecutive visits.

Tune the window with revisit_window_days (default 30, range 1–365): two visits to the same account within that many days count as a revisit. Choose how rows are grouped with group_by (defaults to provider).

---

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 92 days from startdate.
revisit_window_days	integer	No	30	Days within which a second visit to the same account counts as a revisit (1–365).
group_by	string	No	provider	How rows are grouped. One of: provider, device, driver, cause, subcause, service_type, product, origin, shift, end_code, comm_media, route, country, department, city, zone, client, telephonist, operator, resource_type, date, month, weekday, hour.
devices	string	No	—	Comma-separated device IDs. Max 500.
drivers	string	No	—	Comma-separated driver IDs. Max 500.
providers	string	No	—	Comma-separated provider IDs. Max 100.
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.
statuses	string	No	—	Comma-separated task status codes. Max 100.
device_groups	string	No	All	Comma-separated device type IDs (the device_group catalog from Fleet / Devices). Filters tasks to devices of those types; combines with devices as an intersection. Max 100
origins	string	No	—	Comma-separated origin IDs. Max 100.
route_ids	string	No	—	Comma-separated route IDs. Max 100.
operators	string	No	—	Comma-separated operator IDs. Max 100.
client_id	string	No	—	Single client ID.
account_id	string	No	—	Single account ID.
shift_id	string	No	—	Single shift ID.
limit	integer	No	25	Number of records per page (1–100).
offset	integer	No	0	Number of records to skip for pagination.

How device_groups combines with devices

device_groups is expanded to every device of those types, and if you also send devices, only the devices present in both lists are kept. If that intersection is empty the report returns no rows.

---

Code Examples

cURL

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

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/revisits?startdate=2026-03-01T00:00:00&enddate=2026-03-15T23:59:59&revisit_window_days=15&group_by=driver&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/revisits",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={
        "startdate": "2026-03-01T00:00:00",
        "enddate": "2026-03-15T23:59:59",
        "revisit_window_days": 15,
        "group_by": "driver",
        "limit": 25,
    },
)
data = response.json()

---

Response

Response Fields

Field	Type	Description
group_label	string	Display name of the group (e.g. driver, device, provider).
group_id	string | null	Internal ID of the group, or null when not resolvable.
total	number	Total finished tasks in the group.
revisitas	number	Tasks that revisited an account within the window.
primera_visita	number	Tasks that were a first visit (no recent prior visit).
dias_entre_visitas_avg	number	Average days between consecutive visits to the same account.
tasa_revisitas_pct	number	Revisit rate percentage (revisitas / total * 100).
first_time_fix_pct	number	First-time-fix rate percentage ((total − revisitas) / total * 100).

Example Response

{
  "success": true,
  "data": [
    {
      "group_label": "Carlos Martinez",
      "group_id": "10293",
      "total": 120,
      "revisitas": 18,
      "primera_visita": 102,
      "dias_entre_visitas_avg": 6.41,
      "tasa_revisitas_pct": 15.0,
      "first_time_fix_pct": 85.0
    }
  ],
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
VALIDATION_ERROR	400	Invalid params: missing dates, range > 92 days, revisit_window_days outside 1–365, 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

• Time-window Compliance Report
• Quality Score Report
• Accounts Report
• Pagination