GeoTareas Developer Portal
Welcome to the GeoTareas API integration portal. This documentation covers the apidev/v1 API — authentication, task management (create, update, cancel, read, multimedia), fleet management, catalogs, geocoding, telemetry ingestion, and operational reports.
Geocoding is a paid, per-use service
Every endpoint in this portal is included with your plan except the Geocoding API — it is billed per use: each resolved request is deducted from your contracted geocoding quota. Autocomplete, the quota check, and cache hits are free. See the Geocoding page for the full pricing behavior.
What's available
- 70 endpoints across the public integration surface
- Dual authentication: JWT + API Key on every protected request
- Telemetry ingestion for IoT/GPS devices
- Fleet management: devices, drivers, positions (read & write)
- Task management: create (batch), update, cancel, list & detail, and attachments/form PDFs — see Tasks
- Catalogs: 25 lookup endpoints to resolve real IDs (geography cascade, origins, products, causes, OAV…) — see Catalogs
- Geocoding (paid, per-use): forward, reverse, autocomplete, and quota — see Geocoding
- Device messaging: send a message to a mobile and find nearby devices
- 21 report endpoints: AVL satellite tracking (9), GT Operations (5), CPM (4), and General (3)
- Legacy Despacho: GeneXus-compatible compatibility layer for migrating existing integrations
- 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: Tasks, Fleet & Telemetry, Catalogs, Geocoding, Reports.
- 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 |
| Tasks | 8 | Create (batch), update, cancel, list & detail, attachments, form PDFs |
| Fleet & Telemetry | 10 | Devices, drivers, positions, GPS ingestion, mobile messaging, nearby |
| Catalogs | 25 | Lookups to resolve real IDs (geography, origins, products, causes, OAV…) |
| Geocoding (paid) | 5 | Forward, reverse, internal, autocomplete, quota — billed per use |
| Reports — AVL | 9 | Kilometers, geofences, trips, speed, idle, temperature, maintenance, ignition, performance |
| Reports — GT Operations | 5 | Tasks general, alerts, live location, rejected tasks, advanced forms |
| Reports — CPM | 4 | Mobile personnel activity detail, work summary, personnel performance, activity summary |
| Reports — General | 3 | Hardware messages, logins, generated alerts |
| Legacy Despacho | 6 | GeneXus-compatible services under apidev/legacy/* |
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.