Sendstack APIs
  • Introduction
  • The Basics
    • Set up your account
    • Base URLs
    • Authentication
    • Postman
    • Responses and Errors
    • Webhook Verification
    • Pagination
    • Rate Limiting
    • Session
  • Guides
    • Integrated Partners
    • Manual Partners
    • Connected Partners
    • Connected Platforms
    • Payments
    • Addresses and Locations
    • Delivery Statuses
    • Order Tracking
    • Common Terminology
    • Packaging
    • Pay on Delivery
    • Roles and Permissions
      • Associates
      • Operators
      • Admins
      • Super Admins
      • Tabular presentation
    • Websockets
  • Delivery Management APIs
    • Wallet
      • Get Wallet Balance
      • Get Wallet Transactions
    • Locations
      • Get Mapped Locations
      • Get Countries
    • Estimates
      • Get Delivery Price Estimate
    • Partners
      • Get Partners
      • Get Partner
      • Update Partner Profile
      • Add Partner Off Days
      • Delete Partner Off Day
    • Packaging
    • Categories
    • Bookings
      • New Booking
      • Generate POD account number
      • Fetch Deliveries
      • Update Delivery Details
      • Update Drop Statuses
      • Cancel Drops
      • Reschedule Delivery
      • Update Delivery Window
      • Assign Drop
    • Status Tracking
      • Track Delivery Status
    • Messaging
      • Send Customer Message
      • Add Private Note
      • Update note status
    • Sample Webhook Payloads
      • New delivery
      • Updated delivery status
      • New internal note
      • New customer message
      • Pickup attempt
      • Dropoff attempt
      • Pickup window updated
      • Delivery window updated
  • Live Tracking APIs
    • Devices
      • Get Devices
    • Positions
      • Get All Positions
      • Get Device Position History
      • Stream Positions
    • Geofences
      • Create Geofence
      • Update Geofence
      • Fetch Geofences
      • Fetch Single Geofence
    • Events
      • Create Events
        • Overspeed Event
        • Low Battery Event
        • No Movement Event
        • No Signal Event
        • Geofence In Event
        • Geofence Out Event
      • Update Events
        • Overspeed Event
        • Low Battery Event
        • No Movement Event
        • No Signal Event
        • Geofence In Event
        • Geofence Out Event
      • Fetch Events
      • Fetch Single Event
    • Sample Wehook Payloads
      • Overspeed Event
      • Low Battery Event
      • No Movement Event
      • No Signal Event
      • Geofence In Event
      • Geofence Out Event
Powered by GitBook
On this page
  1. Live Tracking APIs
  2. Positions

Stream Positions

To stream real-time positions of your tracking devices, establish a websocket connection as described below.

Request

  • Endpoint: WEBSOCKET {baseUrl}/socket?session=<sessionID>

Response

Once connected, the websocket will stream real-time updates for your tracking devices. The response includes an array of device positions with detailed information.

{
    "positions": [
        {
            "latitude": 6.5010200000000005,
            "longitude": 3.311388333333333,
            "altitude": 0,
            "speed": 0,
            "inMotion": false,
            "lastTransmittedTime": "2025-03-12T16:51:58.000+00:00",
            "deviceId": "67287d2f8faa08541904202b",
            "deviceType": "tracker",
            "batteryLife": 100,
            "course": 54,
            "lastRecordedTime": "2025-03-12T16:51:58.000+00:00",
            "name": "sample Test"
        },
        {
            "latitude": 22.64522666666667,
            "longitude": 114.01978666666668,
            "altitude": 0,
            "speed": 0,
            "inMotion": false,
            "lastTransmittedTime": "2024-11-28T08:45:08.000+00:00",
            "deviceId": "67483ddf2a95ecc18167ff91",
            "deviceType": "tracker",
            "course": 222,
            "lastRecordedTime": "2024-11-28T08:45:08.000+00:00",
            "name": "renamed tracker 3"
        },
        {
            "deviceId": "6780092e89b7bd4c6b0a82be",
            "latitude": 6.437638333333333,
            "longitude": 3.491035,
            "altitude": 0,
            "speed": 0,
            "inMotion": false,
            "lastTransmittedTime": "2025-03-12T19:58:56.000+00:00",
            "batteryLife": 50,
            "deviceType": "tracker",
            "course": 0,
            "lastRecordedTime": "2025-03-12T19:58:56.000+00:00",
            "name": "Test tracker"
        }
    ]
}

PreviousGet Device Position HistoryNextGeofences

Last updated 3 months ago