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-positionscurl -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-etacurl -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_name | min_mile | max_mile | marker_count |
|---|---|---|---|
| MISSISSIPPI-LO | 0 | 953 | 968 |
| MISSISSIPPI-UP | 0 | 878 | 879 |
| OHIO | 0 | 981 | 982 |
| ILLINOIS | 0 | 303 | 303 |
| GIWW-WEST | 0 | 682 | 683 |
| TENNESSEE | 0 | 652 | 653 |
| MISSOURI | 0 | 750 | 751 |
| ARKANSAS | 20 | 394 | 381 |
| TOMBIGBEE | 45 | 217 | 172 |
| ALABAMA | 0 | 306 | 306 |
| CUMBERLAND | 0 | 382 | 382 |
| GREEN | 0 | 109 | 109 |
| RED | 0 | 346 | 339 |
