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

---

Request

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.
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",
      "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": "",
      "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
BAD_REQUEST	400	Missing required headers.
VALIDATION_ERROR	400	Invalid params: 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

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