---
title: "Itinerary Legs"
method: POST
path: "/trips/{trip_id}/itinerary/legs"
tags: ["itinerary"]
---

# Itinerary Legs

`POST /trips/{trip_id}/itinerary/legs`

Road or footpath lines between the given pairs of the trip's places, in
the order asked. Pairs Valhalla cannot route are left out.

## Path parameters

- `trip_id` string, required

## Request body

- ItineraryLegsRequest
  - `legs` LegRequest[], required
    - `from_item_id` string, required
    - `to_item_id` string, required
    - `mode` 'walk' | 'drive', required

## Response `200`

Successful Response

- ItineraryLegsResponse
  - `legs` ItineraryLeg[], required
    - `from_item_id` string, required
    - `to_item_id` string, required
    - `mode` 'walk' | 'drive', required
    - `polyline` string, required
    - `seconds` integer, required
    - `meters` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-09** `c3802252fcff` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stardrift/apis/fastapi/changes/trips/:trip_id/itinerary/legs/post.md)

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc.dev/stardrift/apis/fastapi/revisions/dd78fbd6c358?raw)