Skip to main content
Production · API v1

Build on GeoTareas

Enterprise APIs for the modern field operation. Satellite tracking, task orchestration, billing automation, and supplier workflows — designed for integration teams that ship fast and sleep well.

Build with

APIs that cover the full field operation lifecycle

Authentication

JWT bearer tokens and company-scoped API keys. Validated against tenant, scope, and key lifecycle.

  • login & JWT issuance
  • JWT + API key dual auth

Fleet & Telemetry

8 endpoints for devices, positions, drivers, and high-throughput GPS data ingestion for real-time tracking.

  • devices CRUD & position.last
  • drivers CRUD & telemetry ingestion

Accounts & Clients

8 endpoints to manage company accounts and client records. Full CRUD with tenant-scoped access.

  • accounts list, detail, create, update
  • clients list, detail, create, update

Workflow

12 endpoints for BPMN-based workflow automation. Definitions, instances, timeline, and task management.

  • definitions & instances CRUD
  • timeline & captured data
  • task complete & reassign

Kanban

12 endpoints for visual task boards. Workspaces, boards, cards with move operations, and threaded comments.

  • workspaces & boards
  • cards CRUD & move
  • task state & comments

Reports

32 report endpoints across AVL tracking, task analytics, SLA control, productivity, and CPM.

  • 9 AVL (km, geofence, trips, speed...)
  • 19 GT (tasks, productivity, SLA...)
  • 1 CPM + 3 general reports

Legacy Despacho

GeneXus-compatible SOAP/REST layer for legacy integrations. 10 services for task tracking, multimedia, geocoding, and accounts.

  • WSGetServicios, WSSeguimientoTarea
  • WSGeocoding, WSAltaServicio
  • WSAbmCuentas, WSGetFacturas

Billing

16 endpoints for invoice lifecycle management, tariff catalogs, and automation rules. Full CRUD with export and status transitions.

  • invoices CRUD & export (CSV/XLSX)
  • catalogs, tariffs & automation rules

Portal Proveedores

13 endpoints for supplier invoice management, amount declarations, tolerance engine, and settlement workflows.

  • supplier invoices & batch declarations
  • tolerance validation & settlements
Integration patterns

What teams build with GeoTareas APIs

ERP & Back-office Sync

Push task completions, billing events, and fleet activity into SAP, Oracle, or custom ERPs in real time using webhook-ready REST endpoints.

WorkflowBillingReports

Custom Field Apps

Power mobile and web field-worker apps with task assignment, GPS position updates, digital form submissions, and Kanban board operations.

FleetKanbanTelemetry

Operations Dashboards

Build executive-level visibility with 32 analytics endpoints — SLA control, task productivity, AVL tracking, live fleet positions, and proactivity metrics.

Reports — AVLReports — GTAccounts

From auth to live data
in three requests

Login, attach your API key, and you're querying workflow instances, fleet positions, or billing records. No SDK required — every endpoint speaks JSON over HTTPS.

1Authenticate — get JWT + API key
2Create a workflow instance
3Query its timeline & captured data
Quickstart guide
# 1. authenticate
POST /apidev/v1/login
tenant: acme.geotareas.com

# → { token, apiKey: "gtk_prod_..." }

# 2. start a workflow instance
POST /apidev/v1/workflow/instances
Authorization: Bearer eyJhbG...
X-API-Key: gtk_prod_xxx
{"definitionId":"wf_maint","entityId":"truck-42"}

# 3. fetch timeline
GET /apidev/v1/workflow/instances/inst_9x/timeline
Authorization: Bearer eyJhbG...
X-API-Key: gtk_prod_xxx
102
Endpoints
10
Domains
REST
Protocol
JWT+Key
Security