v1

latestOpenAPI 3.1.02026-07-2451827.5 KB

Carrier API

Submit trip data

Submit trip data for carrier vehicles. Each trip must include vehicle ID, trip number, and legs with start/end coordinates and arrival windows.

post/v1/carrier/coverage/trips

Request body

idstring

Trip identifier

carrier_idstring

Carrier identifier

vehicle_idstring

Vehicle identifier

trip_nostring

Trip number

Example request

[
  {
    "id": "trip-001",
    "carrier_id": "carrier-123",
    "vehicle_id": "TRUCK-001",
    "trip_no": "TRIP-2026-100",
    "legs": [
      {
        "start_lat": 33.787363,
        "start_long": -118.163715,
        "start_time": "2025-02-20T08:00:00Z",
        "end_lat": 34.052235,
        "end_long": -118.243683,
        "arrival_window_start": "2025-02-20T12:00:00Z",
        "arrival_window_end": "2025-02-20T16:00:00Z",
        "available_for_offers": true,
        "est_drive_time_minutes": 240
      }
    ]
  }
]

Response

Trips accepted and processed; returns count of trips added

integer required