Skip to main content

API Overview

The Tracker GraphQL API provides a flexible interface for managing tracking devices, monitoring location history, and handling real-time updates. This documentation covers all available queries, mutations, and types.

Authentication​

All API requests require a valid JWT token with a client_list claim. See the Authentication guide for details.

GraphQL Endpoints​

  • Main Endpoint: /graphql
  • WebSocket: /graphql (for subscriptions)

Core Concepts​

Queries​

  • Location history retrieval with ordering and filtering
  • Tracker status, information, and duration statistics
  • Production and delivery data with image support
  • Paginated data access using cursor-based connections

Mutations​

  • Update tracker status and duration tracking
  • Manage location history with enhanced filtering
  • Configure tracking settings and production metadata
  • Handle image URLs for production runs

Real-time Updates​

  • Socket.IO based updates
  • Live location tracking with ordering capabilities
  • Status change notifications with duration tracking
  • Enhanced geocoding processing

Pagination and Filtering​

  • Cursor-based pagination through connections
  • Flexible ordering options for trackers and location history
  • Advanced filtering by status, brand, and production run
  • Duration-based statistics and analysis

Rate Limiting​

The API implements rate limiting based on client credentials. Contact your account manager for details about your rate limits.

Error Handling​

GraphQL errors are returned in the standard format:

{
  "errors": [
    {
      "message": "Error message here",
      "path": ["path", "to", "field"],
      "extensions": {
        "code": "ERROR_CODE"
      }
    }
  ]
}