---
title: "Progresses the status of the booking to the requested state."
method: PATCH
path: "/bookings/{id}/status"
tags: ["bookings"]
---

# Progresses the status of the booking to the requested state.

`PATCH /bookings/{id}/status`

Examples:

negotiating -> approved
approved -> handed_off
handed_off -> returned
approved -> renter_cancelled/owner_cancelled

## Path parameters

- `id` integer, required

## Request body

- StatusChangeRequest
  - `as_credits` boolean
  - `cancel_reason` string
  - `claim_id` string
  - `comment` string
  - `decline_reason` string
  - `details` string
  - `expires` string
  - `from` string
  - `handle_future_bookings` boolean
  - `multiple_booking_choice` string
  - `no_send_email` boolean
  - `paypal_charge_info` PaypalChargeInfo
    - `details` PaypalChargeDetails
      - `details` PaypalChargeDetailsDetails
        - `billingAddress` PaypalAddress
          - `city` string
          - `countryCode` string
          - `line1` string
          - `line2` string
          - `postalCode` string
          - `state` string
        - `countryCode` string
        - `email` string
        - `firstName` string
        - `lastName` string
        - `payerId` string
        - `phone` string
        - `shippingAddress` PaypalAddress
          - `city` string
          - `countryCode` string
          - `line1` string
          - `line2` string
          - `postalCode` string
          - `state` string
      - `deviceData` string
      - `nonce` string
      - `type` string
    - `payer_id` string
    - `token` string
  - `refund_amount` integer
  - `refund_type` string
  - `rental_charge` RentalCharge
    - `card_id` integer
    - `card_token` string
    - `full` boolean
    - `method` string
    - `payment_intent_id` string
    - `payment_meta` unknown
    - `payment_source` string
  - `reset_approval_and_resend` boolean
  - `save_card_token` string
  - `security_deposit_charge` SecurityDepositCharge
    - `card_id` integer
    - `card_token` string
    - `method` string
    - `payment_intent_id` string
    - `payment_meta` unknown
    - `payment_source` string
  - `status` string
  - `to` string
  - `user_notices_acknowledged` integer[]
  - `waive_penalties` boolean

## Other responses

- `200` — unresolved $ref
- `401` — Unauthorized error
- `404` — Not found error
- `default` — An unknown, unexpected error.

---

[API](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation.md) · [All operations](https://skmtc.net/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/outdoorsy/outdoorsy-api-documentation/revisions/f0cf8f605ea0/schema)