---
title: "Import trips"
method: POST
path: "/v2/organisations/{organisation_id}/trips/import"
tags: ["Gateway GRPC"]
---

# Import trips

`POST /v2/organisations/{organisation_id}/trips/import`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/trips/import`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Request body

- CreateTripRequestDto[]
  - `route_id` string, required: Route ID
  - `trip_name` string, required: Trip name
  - `vehicles` VehicleDetailsDto[], required: Vehicles with their individual schedules
    - `vehicle_id` string, required: Vehicle ID
    - `frequency` FrequencyDto
      - `day` number[], required: Days of week for the trip
      - `start_time` string, required: Trip start time
      - `end_time` string, required: Trip end time
      - `end_day_offset` number: Number of calendar days after the start day when the trip ends
    - `frequencies` FrequencyDto[]: Vehicle trip frequencies
      - `day` number[], required: Days of week for the trip
      - `start_time` string, required: Trip start time
      - `end_time` string, required: Trip end time
      - `end_day_offset` number: Number of calendar days after the start day when the trip ends

## Response `200`

Per-trip import results

- BulkCreateTripsResponseDto
  - `results` BulkCreateTripResultDto[], required
    - `index` number, required: Zero-based request index
    - `success` boolean, required: Whether this trip was created
    - `trip_id` string, uuid
    - `message` string

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)
