---
title: "GET /bids"
method: GET
path: "/bids"
tags: ["instamatch"]
---

# GET /bids

`GET /bids`

Return list of bids

## Query parameters

- `id` integer
- `ids` string
- `owner_id` integer
- `open` boolean
- `limit` integer
- `offset` integer
- `order` string
- `bid_match_owner_id` integer
- `location_ids` integer[]
- `source` string
- `created_gt` string
- `created_lt` string
- `from_gt` string
- `from_lt` string
- `to_gt` string
- `to_lt` string
- `max_day_price_gt` integer
- `max_day_price_lt` integer
- `min_day_price_gt` integer
- `min_day_price_lt` integer
- `price_per_day_gt` integer
- `price_per_day_lt` integer
- `created_by_booking_id` integer
- `closed_by_booking_id` integer
- `delivery` boolean
- `stationary_delivery` boolean
- `travelers` integer
- `make` string
- `model` string
- `year` integer
- `type` string
- `renter_id` integer
- `rental_id` integer

## Response `200`

HTTP status code 200 and array of bid models

- Bid[]
  - `bid_matches` BidMatch[]
    - `bid_id` Bid — recursive
    - `booking_id` integer
    - `conversation_id` integer
    - `created` string
    - `id` integer
    - `match_location_type` string, nullable
    - `message_sent` boolean
    - `owner_id` integer
    - `owner_read` boolean
    - `rental_id` integer
    - `renter_id` integer
    - `score` integer, nullable
    - `status` string
    - `updated` string
  - `close_reason` string
  - `closed` string
  - `closed_by_booking_id` integer
  - `comments` string
  - `created` string
  - `created_by_booking_id` integer, nullable
  - `delivery` boolean, nullable
  - `dest_lat` number, double
  - `dest_lng` number, double
  - `destination` string
  - `email` string
  - `festival_friendly` boolean
  - `from` string
  - `id` integer
  - `ip_lookup` boolean
  - `make` string — storage for display to owner receiving bid
  - `max_budget` integer
  - `max_day_price` integer
  - `message_sent` boolean
  - `min_budget` integer
  - `min_day_price` integer
  - `model` string
  - `name` string
  - `offer_delivery` boolean
  - `open` boolean
  - `owner_id` integer
  - `owner_read` boolean
  - `pet_friendly` boolean
  - `pickup_lat` number, double
  - `pickup_lng` number, double
  - `pickup_location` string
  - `price_per_day` integer
  - `quality` NullFloat64 — NullFloat64 implements the [Scanner] interface so it can be used as a scan destination, similar to [NullString].
    - `Float64` number, double
    - `Valid` boolean
  - `rental_id` integer
  - `seatbelts` integer
  - `sent` boolean — Sent is populated dynamically for the requesting owner
  - `smoking_allowed` boolean
  - `source` string
  - `stationary_delivery` boolean, nullable
  - `tailgate_friendly` boolean
  - `to` string
  - `travelers` integer
  - `type` string
  - `updated` string
  - `year` integer

## Other responses

- `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/versions/f0cf8f605ea0/schema)