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 owner and owner_list are supplied,owner_list is used.
  • tow_type (optional when an owner filter is provided): canonical values aregrain, 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 overowner if 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-time
curl -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.