Skip to main content

Postman Collection

Download​

Ready-to-import files, published directly from the generated collection:

  • Postman collection — all requests, pre-configured with dual auth (JWT + API Key).
  • Environment — variables for every request. baseUrl points to https://apidev.geotareas.com; fill in your credentials (apiKey, email, password) and the catalog IDs of your tenant.

To use: open Postman → Import → drop both files → select the environment in the top-right selector.

Request Inventory​

Auth (1)​

  • POST Login

Fleet (7)​

  • GET List Devices
  • GET Device Detail
  • GET Device Position
  • PUT Update Device
  • GET List Drivers
  • POST Create Driver
  • PUT Update Driver

Telemetry (1)​

  • POST Ingest Batch

Tasks (8)​

  • GET List Tasks
  • GET Task Detail
  • POST Create Tasks (batch)
  • PUT Update Tasks
  • DELETE Cancel Tasks
  • GET Task Attachments
  • GET Download Attachment
  • GET Form PDF

Devices — Messaging (2)​

  • POST Send Message to Mobile
  • POST Devices Nearby

Catalogs (25)​

  • GET Geographic: countries, departments, cities, zones, special places (+ types)
  • GET Domain: origins, origin products, product coverages, services, service causes, cause subcauses, reasons, priorities, task statuses, shifts
  • GET Resources: end reasons, forms, form lists, vehicle types, providers, devices · POST products → end reasons
  • GET OAV: product OAV fields

Geocoding (5) — paid per use​

  • POST Forward
  • POST Reverse
  • POST Internal (our maps)
  • POST Autocomplete
  • GET Quota

Reports — AVL (9)​

  • GET Kilometers
  • GET Geofence
  • GET Trips
  • GET Speed
  • GET Idle
  • GET Temperature
  • GET Maintenance
  • GET Ignition
  • GET Vehicle Performance

Reports — CPM (4)​

  • GET Activity Detail
  • GET Work Summary
  • GET Personnel Performance
  • GET Activity Summary

Reports — General (3)​

  • GET Hardware Messages
  • GET Logins
  • GET Generated Alerts

Reports — GT Analytics (10)​

  • GET Quantity of Services
  • GET Arrival Time
  • GET Attention Time
  • GET Assignment Time
  • GET Service Full Time
  • GET Total Service Time
  • GET Control Arrival Time
  • GET Control Total Time
  • GET Delay Bands
  • GET Task Kilometers

Reports — GT Advanced (7)​

  • GET SLA Multilevel
  • GET Benchmark
  • GET Fleet Efficiency
  • GET Demand Capacity
  • GET Time Window Compliance
  • GET Quality Score
  • GET Revisits

Reports — GT Operations (9)​

  • GET Tasks General
  • GET Alerts
  • GET Live Location
  • GET Rejected Tasks
  • GET Advanced Forms
  • GET Productivity
  • GET Accounts Report
  • GET Proactivity Device
  • GET Proactivity Task

Reports — Workflow (7)​

  • GET Instances
  • GET Tasks
  • GET SLA Compliance
  • GET User Productivity
  • GET Workflow Performance
  • GET Group Activity
  • GET Timeline

Reports — Portal (5)​

  • GET Dashboard
  • GET Differences
  • GET Billing
  • GET Settlements
  • GET Tolerance

Workflow (12)​

  • GET List Definitions
  • GET Definition Detail
  • GET List Instances
  • GET Instance Detail
  • GET Instance Timeline
  • GET Instance Captured Data
  • POST Start Workflow
  • POST Cancel Instance
  • GET List Tasks
  • GET Task Detail
  • POST Complete Task
  • POST Reassign Task

Kanban (12)​

  • GET List Workspaces
  • GET List Boards
  • GET Board Detail
  • GET Board Tasks
  • PUT Change Task State
  • GET List Cards
  • GET Card Detail
  • POST Create Card
  • PUT Update Card
  • PUT Move Card
  • GET List Comments
  • POST Create Comment

Supplier Portal (12)​

  • GET List Invoices
  • GET Invoice Detail
  • POST Declare Invoice Amount
  • POST Declare Batch
  • POST Validate Amount
  • GET Invoice States Catalog
  • GET Concepts Catalog
  • GET Effective Tolerance
  • GET List Settlements
  • GET Settlement Detail
  • POST Create Settlement
  • PUT Submit Settlement

Accounts (4)​

  • GET List Accounts
  • GET Account Detail
  • POST Create Account
  • PUT Update Account

Clients (4)​

  • GET List Clients
  • GET Client Detail
  • POST Create Client
  • PUT Update Client

Audit (2)​

  • GET Config
  • GET Tasks

Legacy Despacho (6)​

  • POST WSGetServicios
  • POST WSGetTareaMultimedia
  • POST WSGeocoding (CalleEsquina + CalleNumero + RutaKm)
  • POST WSReverseGeocoding
  • POST WSGetArchivosMultimedia (3 operations)
  • POST WSAltaServicio (Crear + Cancelar)

Variables​

VariableDescription
baseUrlAPI base URL (e.g. https://geotareas.com)
tenantYour assigned tenant domain (default: geotareas.com)
emailLogin email
passwordLogin password
tokenJWT token (auto-set by Login request)
apiKeyAPI key from onboarding
deviceIdDevice ID for detail/position/update
driverIdDriver ID for update
taskIdTask ID for detail and attachments
startDateReport start date (ISO 8601)
endDateReport end date (ISO 8601)

Auto-configured Behavior​

  • Login auto-saves token from data.authorization
  • All protected requests send Authorization: Bearer {{token}} + X-API-Key: {{apiKey}} + tenant: {{tenant}}

Quick Test Flow​

  1. Run Login — token is saved automatically
  2. Run List Devices — copy an id to deviceId
  3. Run Device Detail and Device Position
  4. Run any report with startDate and endDate set
  5. For Telemetry, use the same token and apiKey
  6. For Tasks, get a taskId from List Tasks before calling detail or attachments