Bookings

Get a booking

Status, payment, refund schedule and host notes for a booking your agent made. Poll this (or listEvents) to follow a request until the host answers.

get/v1/bookings/{booking_id}

Request

  • Base URL: https://threshold.rentals/api
  • URL: https://threshold.rentals/api/v1/bookings/{booking_id}
  • Auth: HTTP bearer

Path parameters

booking_idstring required

Response

The booking

idstring
confirmation_codestring
status'awaiting_payment' | 'pending_host_confirmation' | 'confirmed' | 'declined' | 'expired' | 'cancelled_by_guest' | 'cancelled_by_host' | 'cancelled_unpaid'
property_idstring
check_instring date
check_outstring date
host_confirm_bystring date-time
arrival_info_available_atstring date-time
arrival_info_sent_atstring date-time
special_requestsstring
host_messagestring
created_atstring date-time

Example response

{
  "check_in": "2026-11-13",
  "check_out": "2026-11-13",
  "total": {
    "currency": "USD"
  },
  "amount_paid": {
    "currency": "USD"
  },
  "amount_refunded": {
    "currency": "USD"
  },
  "refund_schedule": [
    {
      "refund": {
        "currency": "USD"
      }
    }
  ]
}

Changes

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