Itinerary

Create Itinerary

Create a new visual itinerary. With trip_external_id the trip's existing itinerary is returned (200, reused) unless new is true.

post/api/v1/itineraries

Request

  • Base URL: https://www.endlesstravelplans.com
  • URL: https://www.endlesstravelplans.com/api/v1/itineraries
  • Auth: HTTP bearer

Request body

trip_external_idstring nullable

Link to a trip.

input_destinationstring required

The destination.

start_datestring required
end_datestring required

Must be after start_date.

num_adultsinteger required
num_childreninteger required
children_agesinteger[]
intensity_levelstring nullable
selected_categoriesstring[]
newboolean

Create a fresh draft even when the trip already has one.

Example request

{
  "trip_external_id": "550e8400-e29b-41d4-a716-446655440000",
  "input_destination": "Paris, France",
  "start_date": "2026-04-01",
  "end_date": "2026-04-08",
  "num_adults": 2,
  "num_children": 1,
  "children_ages": [
    5
  ],
  "intensity_level": "Moderate",
  "selected_categories": [
    "Culture",
    "Food"
  ]
}

Response

reusedboolean

Example response

{
  "itinerary": {
    "external_id": "uuid",
    "status": "finished"
  },
  "reused": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.