---
title: "Submit trip data"
method: POST
path: "/v1/carrier/coverage/trips"
tags: ["Carrier API"]
---

# Submit trip data

`POST /v1/carrier/coverage/trips`

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

## Request body

- CarrierTripRequest[]
  - `id` string — Trip identifier
  - `carrier_id` string — Carrier identifier
  - `vehicle_id` string — Vehicle identifier
  - `trip_no` string — Trip number
  - `legs` CarrierTripLeg[] — Ordered list of trip legs
    - `start_lat` number, double — Start latitude
    - `start_long` number, double — Start longitude
    - `start_time` string, date-time — Departure time (ISO 8601 format)
    - `end_lat` number, double — End latitude
    - `end_long` number, double — End longitude
    - `arrival_window_start` string, date-time — Earliest arrival time (ISO 8601 format)
    - `arrival_window_end` string, date-time — Latest arrival time (ISO 8601 format)
    - `available_for_offers` boolean — Whether the vehicle is available for offers on this leg
    - `est_drive_time_minutes` integer — Estimated drive time in minutes
    - `stop_number` integer — Stop sequence number (0-based)

## Response `200`

Trips accepted and processed; returns count of trips added

- integer

## Other responses

- `400` — Invalid request: missing required fields or invalid trip data
- `401` — Unauthorized: missing or invalid bearer token
- `403` — Forbidden: API access is not enabled for this carrier
- `404` — Carrier not found
- `500` — Internal server error

---

[API](https://skmtc.dev/shipoway/apis/oway-carrier-api.md) · [All operations](https://skmtc.dev/shipoway/apis/oway-carrier-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shipoway/oway-carrier-api/revisions/7b44d4a2e98a/schema)