---
title: "Prepare a stay for the guest to confirm and pay — returns a link, reserves nothing"
method: POST
path: "/api/public/v1/p/{slug}/checkouts"
---

# Prepare a stay for the guest to confirm and pay — returns a link, reserves nothing

`POST /api/public/v1/p/{slug}/checkouts`

## Request

- Base URL: `https://posadita.com`
- URL: `https://posadita.com/api/public/v1/p/{slug}/checkouts`
- Auth: none declared

## Path parameters

- `slug` string, required

## Request body

- object
  - `checkIn` string, date, required
  - `checkOut` string, date, required
  - `adults` integer, required
  - `children` integer
  - `guest` object: Optional. Pre-fills the form; the guest can change it.
    - `firstName` string
    - `lastName` string
    - `email` string
    - `phone` string
  - `message` string: Optional note to the host, pre-filled.
  - `locale` string
  - `agent` string: Who is asking, e.g. the assistant's name. Shown to nobody but the host's statistics.

## Response `201`

Send `checkoutUrl` to the guest.

- object
  - `checkoutUrl` string, uri
  - `expiresAt` string, date-time
  - `quote` object
    - `ok` unknown, required
    - `checkIn` string, date, required
    - `checkOut` string, date, required
    - `adults` integer
    - `children` integer
    - `nights` integer, required
    - `currency` string, required: ISO 4217
    - `totalCents` integer, required: Everything the guest pays for the stay, in minor units.
    - `breakdown` object
      - `nightsCents` integer
      - `lengthDiscountCents` integer
      - `extraGuestFeeCents` integer
      - `cleaningFeeCents` integer
      - `promoDiscountCents` integer
  - `next` string

## Other responses

- `404`: The place does not take bookings online
- `422`: The stay cannot be booked as asked
- `429`: Too many checkouts from this address

---

[API](https://skmtc.dev/posadita/apis/posadita-direct-booking.md) · [All operations](https://skmtc.dev/posadita/apis/posadita-direct-booking/llms.txt) · [OpenAPI document](https://skmtc.dev/posadita/apis/posadita-direct-booking/revisions/5a4a24c27407?raw)