Accounts Report

Account master data with client, provider, location, and service balance details. No date range required.

GET/apidev/v1/reports/gt/accounts

PermissionAPICLI_RPTGT_CUENTAS

Rate Limit10 req/min

Cache300s

---

Overview

Returns account master data as a current snapshot (no date range required) — full identity, tax and document details, contacts, location with coordinates, the linked client and provider, service balances (initial, used, remaining), and associated vehicle. Filter by client, provider, account type, geography, or status, or run a free-text search.

---

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
client_id	string	No	—	Filter by client ID.
provider_id	string	No	—	Filter by provider ID.
account_type	string	No	—	Filter by account type.
country_id	string	No	—	Filter by country ID.
department_id	string	No	—	Filter by department ID.
city_id	string	No	—	Filter by city ID.
status	enum	No	—	Account status: active, inactive.
search	string	No	—	Free text search. Max 200 chars.
limit	integer	No	25	Number of records per page (1–100).
offset	integer	No	0	Number of records to skip for pagination.

No date range required

This is a snapshot report. The startdate and enddate parameters are not used.

---

Code Examples

cURL

curl -s -H "Authorization: Bearer $TOKEN" \
  -H "X-API-Key: $APIKEY" \
  -H "tenant: $TENANT" \
  "https://$TENANT/apidev/v1/reports/gt/accounts?status=active&limit=25"

JavaScript

const res = await fetch(
  `https://${TENANT}/apidev/v1/reports/gt/accounts?status=active&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/accounts",
    headers={"Authorization": f"Bearer {TOKEN}", "X-API-Key": APIKEY, "tenant": TENANT},
    params={"status": "active", "limit": 25},
)
data = response.json()

---

Response

Response Fields

Field	Type	Description
account_id	string | null	Account identifier.
account_name	string	Account name.
account_notes	string	Account notes.
account_external_code	string	Account unique/external code.
task_count	number | null	Tasks for the account in the period. Only returned when account_type selects task-bearing accounts (conTareas / ambas); otherwise null.
last_successful_task	object | null	Last task closed with a successful completion code (task_number, completion_code, status, created_at, finished_at). Only returned when the underlying report is asked for it; otherwise null.
products	string	Origin / product (and coverage) configured on the account, in one line.
routes	string	Fixed routes the account belongs to, with their status, in one line.
start_date	string | null	Account start date.
end_date	string | null	Account end date.
account_type	string	Account type.
tax_id	string	Tax identification number.
legal_name	string	Legal name.
doc_type	string	Document type.
document	string	Document number.
phone	string	Phone number.
mobile	string	Mobile number.
email	string	Email address.
client_id	string | null	Client identifier.
client_name	string	Client name.
provider_id	string | null	Provider identifier.
provider_name	string	Provider name.
coverage_area	string	Coverage area.
country	string	Country name.
department	string	Department/state name.
city	string	City name.
address	string	Street address.
postal_code	string	Postal code.
latitude	number | null	Latitude.
longitude	number | null	Longitude.
initial_services_balance	number	Initial services balance.
services_used	number	Services consumed.
services_remaining	number	Services remaining.
vehicle_make	string	Vehicle make.
vehicle_model	string	Vehicle model.
vehicle_year	string	Vehicle year.

Example Response

{
  "success": true,
  "data": [
    {
      "account_id": "104820579501",
      "account_name": "Sucursal Centro",
      "account_notes": "Main downtown branch",
      "account_external_code": "EXT-9912",
      "task_count": 14,
      "last_successful_task": {
        "task_number": "55012",
        "completion_code": "Resuelto en el lugar",
        "status": "FIN",
        "created_at": "2026-03-05T08:15:00",
        "finished_at": "2026-03-05T10:30:00"
      },
      "products": "Asistencia - Mecanica (AMBA) | Asistencia - Grua (AMBA)",
      "routes": "Ruta Norte (A) Estado (A)",
      "start_date": "2025-01-15",
      "end_date": null,
      "account_type": "Commercial",
      "tax_id": "30-71234567-9",
      "legal_name": "Distribuidora Norte S.A.",
      "doc_type": "CUIT",
      "document": "30712345679",
      "phone": "+54 11 4555-1234",
      "mobile": "+54 9 11 5678-9012",
      "email": "centro@distribuidoranorte.com",
      "client_id": "104820579601",
      "client_name": "Distribuidora Norte",
      "provider_id": "104820579701",
      "provider_name": "LogiServ",
      "coverage_area": "AMBA",
      "country": "Argentina",
      "department": "Buenos Aires",
      "city": "CABA",
      "address": "Av. Reforma 1234, Col. Centro",
      "postal_code": "C1043",
      "latitude": -34.6037,
      "longitude": -58.3816,
      "initial_services_balance": 100,
      "services_used": 78,
      "services_remaining": 22,
      "vehicle_make": "Toyota",
      "vehicle_model": "Hilux",
      "vehicle_year": "2024"
    },
    {
      "account_id": "104820579502",
      "account_name": "Bodega Sur",
      "account_notes": "",
      "account_external_code": "",
      "task_count": null,
      "last_successful_task": null,
      "products": "Sin Configurar",
      "routes": "Sin Ruta",
      "start_date": "2025-06-01",
      "end_date": "2026-06-01",
      "account_type": "Industrial",
      "tax_id": "",
      "legal_name": "Logistica Express S.R.L.",
      "doc_type": "",
      "document": "",
      "phone": "",
      "mobile": "+54 9 11 3456-7890",
      "email": "bodega@logisticaexpress.com",
      "client_id": "104820579602",
      "client_name": "Logistica Express",
      "provider_id": null,
      "provider_name": "",
      "coverage_area": "",
      "country": "Argentina",
      "department": "Buenos Aires",
      "city": "Avellaneda",
      "address": "Calle 5 de Mayo 567",
      "postal_code": "1870",
      "latitude": -34.6633,
      "longitude": -58.3653,
      "initial_services_balance": 50,
      "services_used": 50,
      "services_remaining": 0,
      "vehicle_make": "",
      "vehicle_model": "",
      "vehicle_year": ""
    }
  ],
  "meta": {
    "total": 2,
    "limit": 25,
    "offset": 0
  }
}

---

Errors

Code	HTTP	Description
VALIDATION_ERROR	400	Invalid params: 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

• Tasks General Report
• Advanced Forms Report
• Live Location Report
• Pagination