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.
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
- 149 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
- Accounts & Clients: full CRUD — see Accounts and Clients
- Workflow & Kanban runtime: definitions, instances, tasks, boards, cards and comments
- Supplier Portal: invoices, declarations, tolerance and settlements
- Audit: configuration and task change history
- 54 report endpoints: AVL (9), GT (26: operations, analytics and advanced), CPM (4), General (3), Workflow (7), and Supplier Portal (5)
- 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, Accounts & Clients, Catalogs, Geocoding, Workflow, Kanban, Supplier Portal, Reports.
- Postman Collection — Import the ready-to-use collection for manual testing.
API at a glance
149 endpoints under apidev/v1, plus 6 compatibility services under apidev/legacy/*.
| 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 |
| Accounts | 4 | Customer accounts — list, detail, create, update |
| Clients | 4 | Clients — list, detail, create, update |
| Catalogs | 25 | Lookups to resolve real IDs (geography, origins, products, causes, OAV…) |
| Geocoding (paid) | 5 | Forward, reverse, internal, autocomplete, quota — billed per use |
| Workflow | 12 | Definitions, instances, timeline, captured data, tasks (complete, reassign) |
| Kanban | 12 | Workspaces, boards, task state, cards (create, update, move) and comments |
| Supplier Portal | 12 | Invoices, declarations (single and batch), tolerance, settlements |
| Audit | 2 | Configuration change history and task change history |
| Reports — AVL | 9 | Kilometers, geofences, trips, speed, idle, temperature, maintenance, ignition, performance |
| Reports — GT | 26 | Operations (9), analytics (10) and advanced (7): SLA, benchmark, fleet efficiency, quality score, revisits… |
| Reports — CPM | 4 | Mobile personnel activity detail, work summary, personnel performance, activity summary |
| Reports — General | 3 | Hardware messages, logins, generated alerts |
| Reports — Workflow | 7 | Instances, tasks, SLA compliance, productivity, performance, group activity, timeline |
| Reports — Supplier Portal | 5 | Dashboard, differences, billing, settlements, tolerance |
| Legacy Despacho | 6 | GeneXus-compatible services under apidev/legacy/* |
Planner (route optimization) and Billing are documented as a preview but not
exposed: calling them returns 404. Contact the GeoTareas team before building against them.
Design principles
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.