---
title: "Price a booking"
method: POST
path: "/quotes"
tags: ["Quotes"]
---

# Price a booking

`POST /quotes`

## Request

- Base URL: `https://wall.marketing/api/v1`
- URL: `https://wall.marketing/api/v1/quotes`
- Auth: HTTP bearer

Price a set of venues and dates. Checks they are free and returns a quote that holds its price for 30 minutes (it does not hold the screens). end_date is exclusive: a one-day booking on 1 November is start_date 2026-11-01, end_date 2026-11-02. Needs scope quote.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `items` object[]
    - `venue_id` string, required
    - `start_date` string, date, required
    - `end_date` string, date, required
  - `venue_ids` string[]
  - `start_date` string, date
  - `end_date` string, date

## Response `201`

Created

- Quote
  - `object` string: Always "quote".
  - `id` string: The quote_id to book with.
  - `livemode` boolean: False in the sandbox.
  - `items` object[]: One line per venue.
    - `venue_id` string: The venue.
    - `venue_name` string: The venue's name.
    - `address` string, nullable: The venue's address.
    - `start_date` string: First day.
    - `end_date` string: Exclusive end date.
    - `days` integer: Days booked.
    - `daily_rate_usd` number: Price per day, in US dollars.
    - `amount_usd` number: Price for this venue, in US dollars.
  - `total_usd` number: Total price in US dollars, before any VAT.
  - `currency` string: Always "usd".
  - `expires_at` string, nullable: When the quoted price stops holding (30 minutes after it was made). ISO 8601, UTC.
  - `expired` boolean: Whether the quote has expired.
  - `booking_id` string, nullable: The booking made from this quote, if any.
  - `created_at` string, nullable: When the quote was made. ISO 8601, UTC.

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `429`: Error

---

[API](https://skmtc.dev/wall/apis/wall-marketing-platform-api.md) · [All operations](https://skmtc.dev/wall/apis/wall-marketing-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wall/apis/wall-marketing-platform-api/revisions/290b284951e3?raw)