---
title: "GET /search/bookings"
method: GET
path: "/search/bookings"
tags: ["search"]
---

# GET /search/bookings

`GET /search/bookings`

## Request

- Base URL: `https://api.outdoorsy.com/v0`
- URL: `https://api.outdoorsy.com/v0/search/bookings`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `API-Key`
- TypeScript: <https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/docs/search/bookings/get.ts> (a function with typed inputs; its response is checked against the schema)

Search Bookings

## Query parameters

- `archived` boolean
- `filter` string
- `offset` integer
- `limit` integer
- `search` string
- `order_by` string
- `created_gt` string
- `created_lt` string
- `from_gt` string
- `from_lt` string
- `location_ids` string
- `statuses` string
- `new` boolean

## Response `200`

- SearchBookingsResponse
  - `bookings` SearchBooking[]
    - `created` string
    - `dealer_minimum_days` integer
    - `from` string
    - `id` integer
    - `instant_book` boolean
    - `is_request_less_than_minimum_days` boolean
    - `num_reservations` integer
    - `owner_approved` boolean
    - `owner_read` boolean
    - `rental_category` string
    - `rental_id` integer
    - `rental_name` string
    - `renter_approved` boolean
    - `renter_first_name` string
    - `renter_id` integer
    - `renter_last_name` string
    - `status` string
    - `to` string
    - `total` integer
    - `undelivered_emails_count` integer
    - `updated` string
  - `meta` SearchBookingsMeta
    - `abandoned` SearchBookingsMetaCount
      - `status_count` BookingsStatusCount
        - `approved` integer
        - `change_requested` integer
        - `handed_off` integer
        - `imminent` integer
        - `owner_cancelled` integer
        - `renter_cancelled` integer
      - `total` integer
    - `cancelled` SearchBookingsMetaCount
      - `status_count` BookingsStatusCount
        - `approved` integer
        - `change_requested` integer
        - `handed_off` integer
        - `imminent` integer
        - `owner_cancelled` integer
        - `renter_cancelled` integer
      - `total` integer
    - `expired` SearchBookingsMetaCount
      - `status_count` BookingsStatusCount
        - `approved` integer
        - `change_requested` integer
        - `handed_off` integer
        - `imminent` integer
        - `owner_cancelled` integer
        - `renter_cancelled` integer
      - `total` integer
    - `pending` SearchBookingsMetaCount
      - `status_count` BookingsStatusCount
        - `approved` integer
        - `change_requested` integer
        - `handed_off` integer
        - `imminent` integer
        - `owner_cancelled` integer
        - `renter_cancelled` integer
      - `total` integer
    - `returned` SearchBookingsMetaCount
      - `status_count` BookingsStatusCount
        - `approved` integer
        - `change_requested` integer
        - `handed_off` integer
        - `imminent` integer
        - `owner_cancelled` integer
        - `renter_cancelled` integer
      - `total` integer
    - `upcoming` SearchBookingsMetaCount
      - `status_count` BookingsStatusCount
        - `approved` integer
        - `change_requested` integer
        - `handed_off` integer
        - `imminent` integer
        - `owner_cancelled` integer
        - `renter_cancelled` integer
      - `total` integer

## Other responses

- `400`: Invalid input or state means you're bad
- `401`: Unauthorized error

---

[API](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation.md) - [All operations](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/outdoorsy/apis/outdoorsy-api-documentation/revisions/f0cf8f605ea0?raw)