Budget

Create Budget

Create a new budget calculation.

post/api/v1/budgets

Request

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

Request body

trip_external_idstring nullable

Link to a trip.

input_destinationstring required

The destination.

departure_citystring

The departure city.

departure_datestring required
return_datestring required

Must be after departure_date.

num_adultsinteger required

Min 1, max 20.

num_childreninteger required

Min 0, max 20.

children_agesinteger[]

Must be at least 0. Must not be greater than 17.

travel_stylestring required

One of: budget, moderate, luxury.

roomsinteger nullable

Default 1.

departure_city_latitudenumber nullable
departure_city_longitudenumber nullable
transport_mode'rental_car' | 'rideshare' | 'public_transit' | 'walking_only' nullable
cabin_class'economy' | 'premium_economy' | 'business' nullable
departure_countrystring nullable

Must not be greater than 100 characters.

flight_type'round_trip' | 'roundtrip' | 'one_way' | 'multi_city' nullable
trip_type'theme_park' | 'cruise' | 'all_inclusive' | 'city' nullable
park'wdw' | 'uor' | 'dlr' | 'dlp' nullable
stay_tierstring nullable

Must not be greater than 24 characters.

park_daysinteger nullable

Must be at least 1. Must not be greater than 14.

park_hopperboolean nullable
cruise_linestring nullable

Must not be greater than 32 characters.

cabin_type'interior' | 'oceanview' | 'balcony' | 'suite' nullable
portstring nullable

Must not be greater than 32 characters.

cruise_region'caribbean' | 'mediterranean' | 'alaska' nullable
cruise_nightsinteger nullable

Must be at least 2. Must not be greater than 21.

coaststring nullable

Must not be greater than 32 characters.

mode'fly' | 'drive' | 'train' nullable
rail_class'standard' | 'first' nullable
bagsinteger nullable

Must be at least 0. Must not be greater than 6.

insuranceboolean nullable
carrierstring nullable

Must not be greater than 8 characters.

home_countrystring nullable

Must be 2 characters.

presentation_currency'USD' | 'EUR' | 'GBP' | 'CAD' nullable
contingency_pctinteger nullable

Must be at least 0. Must not be greater than 25.

essentialsobject nullable

Example request

{
  "trip_external_id": "550e8400-e29b-41d4-a716-446655440000",
  "input_destination": "Paris, France",
  "departure_city": "New York",
  "departure_date": "2026-04-01",
  "return_date": "2026-04-08",
  "num_adults": 2,
  "num_children": 1,
  "children_ages": [
    15
  ],
  "travel_style": "moderate",
  "rooms": 1,
  "departure_city_latitude": 4326.41688,
  "departure_city_longitude": 4326.41688,
  "transport_mode": "rental_car",
  "cabin_class": "premium_economy",
  "departure_country": "m",
  "flight_type": "multi_city",
  "stops": [
    {
      "destination": "q",
      "nights": 18,
      "order": 16,
      "latitude": 4326.41688,
      "longitude": 4326.41688,
      "country": "m",
      "destination_id": 16
    }
  ],
  "trip_type": "city",
  "park": "wdw",
  "stay_tier": "iyvdljnikhwaykcm",
  "park_days": 9,
  "park_hopper": true,
  "cruise_line": "u",
  "cabin_type": "interior",
  "port": "w",
  "cruise_region": "alaska",
  "cruise_nights": 12,
  "coast": "w",
  "mode": "drive",
  "rail_class": "standard",
  "bags": 2,
  "insurance": true,
  "carrier": "vqwrsitc",
  "home_country": "ps",
  "presentation_currency": "EUR",
  "contingency_pct": 7
}

Response

Example response

{
  "budget": {
    "external_id": "uuid",
    "status": "draft"
  }
}

Changes

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