Skip to main content

Get available deliveries for GPS tracking

GET 
/truckers/deliveries/trackable

This endpoint returns a list of in-progress deliveries that can be tracked via real-time GPS.

Key Features:

  • Only includes deliveries with a 'collected' status (picked up but not delivered)
  • Excludes deliveries associated with auctions
  • Provides essential information for tracking:
    • Unique service code
    • Current delivery status
    • Complete loading (ETL) and unloading (ETD) addresses
    • Geographic coordinates if available
    • Last known vehicle position (if available)

Typical Use Cases:

  • Display all active deliveries on the carrier's map
  • Select a specific delivery to initiate GPS tracking
  • Verify which deliveries are currently en route
  • Plan multiple routes when several deliveries are active
  • Monitor progress of ongoing deliveries

Validations and Restrictions:

  • Requires valid JWT carrier authentication
  • Only shows deliveries assigned to the authenticated carrier
  • Deliveries must be in 'collected' status to appear
  • Does not include completed or canceled deliveries
  • Maximum query frequency: once per minute

Example Flow:

  1. Carrier logs into the mobile app
  2. The app queries this endpoint periodically (every 2-5 minutes)
  3. Active deliveries are displayed on the map with their last known position
  4. The carrier selects one to initiate detailed tracking

Technical Notes:

  • Coordinates are returned in [longitude, latitude] format (GeoJSON)
  • The 'collected' status indicates the cargo has been picked up but not delivered
  • Addresses include city, postal code, and province
  • The response includes an X-Total-Count header with the total number of deliveries

Responses​

List of deliveries available for GPS tracking

Response Headers
    X-Total-Count

    Total number of trackable deliveries

    Example: 2
    X-RateLimit-Remaining

    Number of remaining queries in the current period

    Example: 58