Barge AI API
Concise reference for calling the Barge AI transit time endpoint. Authenticate with your API key using the x-api-key header. Each organization is limited to45,000 requests/month across all products.
GET /barge-ai/transit-time
Returns historical average transit metrics for tows between river points.
Query parameters
- river (required): River name (e.g., "Mississippi").
- tow_type or owner or owner_list (required): provide at least one. If both
ownerandowner_listare supplied,owner_listis used. - tow_type (optional when an owner filter is provided): canonical values are
grain,dry_bulk,liquids,general_cargo,equipment. Common aliases like "dry bulk cargo" and "general cargo" are accepted. - owner (optional): Single owner name.
- owner_list (optional): Comma-separated owners; takes precedence over
ownerif both are present. - min_hp, max_hp (optional): Horsepower filters.
- start_date, end_date (optional): ISO 8601 dates; range ≤ 30 days. When both are omitted, the API defaults to the last 30 days.
Request
GET
/barge-ai/transit-timecurl -X GET "https://api.actionintelgo.com/barge-ai/transit-time?river=Mississippi&tow_type=dry_bulk&start_date=2025-08-20&end_date=2025-08-27" \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json"
Response
Sample response
[
{
"vesselname": "AMERICAN HERITAGE",
"owner": "ARTCO",
"hp": 10500,
"departure_time": "2025-08-24T19:05:05.000",
"arrival_time": "2025-08-25T17:27:35.000",
"trip_time_days": 22.375,
"mean_trip_time_for_week_of_year": 19.66,
"stdev_trip_time_for_week_of_year": 3.53,
"origin": "vicksburg",
"destination": "baton_rouge",
"tow_type": "dry_bulk"
}
]Notes: Date range must not exceed 30 days. Owner names must match canonical formats for best results.
