GeoTareas Developer Portal
Welcome to the GeoTareas API integration portal. This documentation covers the complete apidev/v1 API — authentication, fleet management, reports, accounts, clients, workflow, kanban, telemetry ingestion, billing, and supplier portal.
What's available
- 102 endpoints across 10 functional domains
- Dual authentication: JWT + API Key on every protected request
- Telemetry ingestion for IoT/GPS devices
- Fleet management: devices, drivers, positions (read & write)
- 32 report endpoints: AVL (satellite tracking), GT (task management), CPM, and general
- Accounts & Clients CRUD with dynamic fields (OAV)
- Workflow automation: definitions, instances, timeline, and task management
- Kanban boards: workspaces, boards, cards, and threaded comments
- Billing API: invoices CRUD & export, catalogs, tariffs, and automation rules
- Portal Proveedores API: supplier invoices, amount declarations, tolerance engine, and settlements
- Legacy Despacho: GeneXus-compatible layer with 10 services for task tracking, geocoding, and accounts
- Centralized rate limiting with response headers
- Redis cache on all GET endpoints
Recommended reading path
- Authentication — Understand the dual-auth model (JWT + API Key) and login flow.
- Quickstart — Set up locally and run your first API call.
- Concepts — Read Error Handling, Rate Limits, Pagination, and Partial Updates.
- API Reference — Browse endpoints by domain: Fleet, Reports, Accounts, Clients, Workflow, Kanban, Billing, Portal Proveedores.
- Postman Collection — Import the ready-to-use collection for manual testing.
API at a glance
| Domain | Endpoints | Description |
|---|---|---|
| Authentication | 1 | Login — JWT + API key issuance |
| Fleet & Telemetry | 8 | Devices, drivers, positions, and GPS data ingestion |
| Reports — AVL | 9 | Kilometers, geofences, trips, speed, idle, temperature, maintenance, ignition, performance |
| Reports — GT Analytics | 10 | Service quantity, times, SLA control, delay bands, kilometers |
| Reports — GT Operations | 9 | Tasks, productivity, alerts, live location, forms, proactivity |
| Reports — CPM | 1 | Mobile personnel activity detail |
| Reports — General | 3 | Hardware messages, logins, generated alerts |
| Accounts & Clients | 8 | Full CRUD with products and dynamic fields |
| Workflow | 12 | Definitions, instances, timeline, captured data, task complete & reassign |
| Kanban | 12 | Workspaces, boards, cards CRUD & move, task state, comments |
| Billing | 16 | Invoices CRUD, export, catalogs, tariffs, automation rules |
| Portal Proveedores | 13 | Supplier invoices, declare amounts, tolerance, settlements |
Design principles
Response envelope{ success, data, meta }
UpdatesPartial — send only changed fields
Rate limitsX-RateLimit-* on every response
Tenant isolationJWT + API Key + hostname binding
Portal status
This portal is updated alongside development. Every new feature in apidev is documented here with its corresponding Postman request. The API Coverage page maintains the complete endpoint inventory.