Tow Tracker API

Concise reference for calling Tow Tracker endpoints. Authenticate with your API key using thex-api-key header. Each organization is limited to45,000 requests/month across all products.

GET /tow-tracker/list-positions

Returns the current positional data for the specified vessels.

Query parameters

  • mmsi (required): comma-separated list of up to 100 MMSIs.

Request

GET/tow-tracker/list-positions
curl -X GET "https://api.actionintelgo.com/tow-tracker/list-positions?mmsi=367584670,367618670,367186700"   -H "x-api-key: YOUR_API_KEY"   -H "Content-Type: application/json"

Response

Sample response

[
  {
    "mmsi": "367584670",
    "vesselname": "CYNTHIA II",
    "owner": "ABC",
    "horsepower": 5000,
    "date_time_ct": "2025-08-18T05:27:51-05:00",
    "river": "MISSISSIPPI-LO",
    "mile_marker": 945,
    "reported_speed_knots": 4.0,
    "reported_nav_status": "Power Driven Vessel Pushing Ahead Towing Alongside",
    "direction": "Downbound"
  }
]

GET /tow-tracker/get-eta

Predicts ETA for a single vessel to a destination river mile.

Query parameters

  • mmsi (required): MMSI of the towboat.
  • destination_river (required): Destination river name (e.g., "Mississippi").
  • destination_mile_marker (required): Destination mile marker (e.g., "301").
  • route_selection (optional): default (single best route) orall (return all valid routes).
  • route_strategy (optional): shortest_distance (default) orfewest_hops.

Request

GET/tow-tracker/get-eta
curl -X GET "https://api.actionintelgo.com/tow-tracker/get-eta?mmsi=123456789&destination_river=Mississippi&destination_mile_marker=301&route_strategy=shortest_distance"   -H "x-api-key: YOUR_API_KEY"   -H "Content-Type: application/json"

Response

Sample response

{
  "mmsi": "123456789",
  "vesselname": "Mississippi Queen",
  "destination_river": "Mississippi",
  "destination_mile_marker": "301",
  "route_selection": "default",
  "routes": [
    {
      "route_id": "route_001",
      "eta": "2025-07-28T18:45:00-05:00",
      "total_distance_mi": 130.5,
      "estimated_duration_hr": 23.4
    }
  ]
}

Field definitions and expanded examples are available in the Quickstart guide. For allowed river names, see River name reference.

River names reference

Download the full list as CSV: river_mile_limits.csv

river_namemin_milemax_milemarker_count
MISSISSIPPI-LO0953968
MISSISSIPPI-UP0878879
OHIO0981982
ILLINOIS0303303
GIWW-WEST0682683
TENNESSEE0652653
MISSOURI0750751
ARKANSAS20394381
TOMBIGBEE45217172
ALABAMA0306306
CUMBERLAND0382382
GREEN0109109
RED0346339

Next: Barge AI Overview →