---
title: "Get Budget"
method: GET
path: "/api/v1/budgets/{externalId}"
tags: ["Budget"]
---

# Get Budget

`GET /api/v1/budgets/{externalId}`

## Request

- Base URL: `https://www.endlesstravelplans.com`
- URL: `https://www.endlesstravelplans.com/api/v1/budgets/{externalId}`
- Auth: HTTP bearer

Retrieve a budget calculation by external ID.

## Response `200`

- union
  - object
    - `budget` object
      - `external_id` string
      - `status` string
      - `travel_style` string
  - object: Recorded shape (tests/Fixtures/api-shapes/budgets-show.json)
    - `budget` object
      - `accommodation_confidence` string, nullable
      - `accommodation_source` string, nullable
      - `before_you_book` unknown[]
        - unknown
      - `booking_urls` string, nullable
      - `cabin_class` string, nullable
      - `checked_at` string, nullable
      - `children_ages` unknown[]
        - unknown
      - `children_ages_by_child` unknown[]
        - unknown
      - `confidence` string, nullable
      - `contingency_pct` integer
      - `cost_profile_source` string, nullable
      - `costs` object
        - `accommodation` object
          - `amount` string
          - `currency` string
        - `activities` object
          - `amount` string
          - `currency` string
        - `city_tax` string
        - `departure_tax` string
        - `family_costs` string
        - `flight` object
          - `amount` string
          - `currency` string
        - `flights` integer
        - `food` object
          - `amount` string
          - `currency` string
        - `parking_transport` object
          - `amount` string
          - `currency` string
        - `rental_car` string
        - `resort_fees` object
          - `amount` string
          - `currency` string
        - `snacks_extras` object
          - `amount` string
          - `currency` string
        - `souvenirs` object
          - `amount` string
          - `currency` string
        - `tips_gratuities` object
          - `amount` string
          - `currency` string
        - `transport` object
          - `amount` string
          - `currency` string
        - `wifi_roaming` object
          - `amount` string
          - `currency` string
      - `created_at` string
      - `current_step` integer
      - `departure_city` string
      - `departure_city_latitude` string, nullable
      - `departure_city_longitude` string, nullable
      - `departure_country` string, nullable
      - `departure_date` string
      - `destination` object
        - `name` string
      - `excluded_hidden_costs` unknown[]
        - unknown
      - `external_id` string
      - `flight_cabin_class` string, nullable
      - `flight_confidence` string, nullable
      - `flight_fare_bands` string, nullable
      - `flight_source` string, nullable
      - `flight_type` string
      - `fx_at` string, nullable
      - `fx_rate` string, nullable
      - `headline_total` object
        - `amount` string
        - `currency` string
      - `input_destination` string
      - `is_shared` boolean
      - `known_share` string, nullable
      - `legs` unknown[]
        - unknown
      - `lines` unknown[]
        - unknown
      - `needs_resync` boolean
      - `not_included` unknown[]
        - unknown
      - `num_adults` integer
      - `num_children` integer
      - `presentation_currency` string
      - `pricing_version` string, nullable
      - `regional_adjustments` string, nullable
      - `return_date` string
      - `rooms` integer
      - `status` string
      - `total_travelers` integer
      - `totals` object
        - `buffer` object
          - `amount` string
          - `currency` string
        - `complete` object
          - `amount` string
          - `currency` string
        - `daily_rate` integer
        - `hidden_costs` object
          - `amount` string
          - `currency` string
        - `known_costs` object
          - `amount` string
          - `currency` string
        - `with_buffer` object
          - `amount` string
          - `currency` string
      - `transport_mode` string, nullable
      - `travel_style` string
      - `trip_duration_days` integer
      - `trip_type` string, nullable
      - `updated_at` string
      - `ways_to_save` unknown[]
        - unknown

## Other responses

- `401`: unauthenticated: No valid bearer token was sent.
- `404`
- `429`: rate_limited: A throttle or a per-account allowance refused the request; `retry_after` or `remaining` may be present.
- `500`: server_error: Unhandled failure; quote `request_id` to support.

---

[API](https://skmtc.dev/endlesstravelplans/apis/endless-travel-plans-api.md) · [All operations](https://skmtc.dev/endlesstravelplans/apis/endless-travel-plans-api/llms.txt) · [OpenAPI document](https://skmtc.dev/endlesstravelplans/apis/endless-travel-plans-api/revisions/ae82ed3e4a8f?raw)