Create quote

Price a slot, hold it and get the confirmation summary

POST/v1/quotes

curl -X POST 'https://www.yovamos.com/v1/quotes' \
  -H "Authorization: Bearer $VAMOS_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "slotId": "slt_WzIsIjF2OGcweWgxMWpsOHRpIiwiMXd3dnlvMjAwN3luYngiLDE3OTk3NzMyMDAwMDAsMTc5OTc3NTkwMDAwMCwiMG5ndnRkbTE3ejQ0cWYiLDFd"
}'

{
  "id": "qte_8fK2mQ4xN7vRjT1aZc9LpA",
  "expiresAt": "2027-01-11T21:55:00Z",
  "business": {
    "id": "biz_1v8g0yh11jl8ti",
    "name": "The Spot Barbershop",
    "address": "120 Main St, Los Angeles, CA 90012"
  },
  "service": {
    "id": "svc_1wwvyo2007ynbx",
    "name": "Haircut"
  },
  "staff": {
    "id": "stf_0ngvtdm17z44qf",
    "name": "Marcus"
  },
  "startsAt": "2027-01-12T17:00:00Z",
  "local": "Tue, Jan 12 · 9:00–9:45 AM PST",
  "durationMinutes": 45,
  "partySize": 1,
  "price": {
    "total": {
      "amountMinor": 3500,
      "currency": "USD",
      "display": "$35.00"
    }
  },
  "confirmation": "instant",
  "businessCancellationPolicy": "Free cancellation until 24 hours before your appointment.",
  "needs": [
    "name",
    "email"
  ],
  "summary": "“Haircut” with “Marcus” at “The Spot Barbershop” (“120 Main St, Los Angeles, CA 90012”), Tue, Jan 12 · 9:00–9:45 AM PST, for 1 person. Total $35.00. Free cancellation until Mon, Jan 11 · 9:00 AM PST. It is confirmed as soon as you book. Held for you until Mon, Jan 11 · 1:55 PM PST.",
  "untrusted": [
    "business.name",
    "business.address",
    "service.name",
    "staff.name",
    "businessCancellationPolicy"
  ],
  "continueUrl": "https://www.yovamos.com/continue?quote=qte_8fK2mQ4xN7vRjT1aZc9LpA"
}

Headers

AuthorizationBearer tokenRequired
Your app key. Authentication

Body

slotIdstringRequired
Opaque slot id as returned by list_available_slots (prefix slt_). Copy it exactly; never construct one yourself.
partySizeinteger (1–50)
Number of people attending. Defaults to the party size the slot was listed for.
promoCodestring (up to 40 characters)
Promo code the customer mentioned, if any.
customerQuoteCustomer
Optional. Who the booking is for.
customer.emailstring (up to 254 characters)
The customer's email, if you already have it. It lets us tell you now whether the business will confirm instantly or review first.
customer.namestring (up to 120 characters)
Full name as the customer wants it on the booking.

Responses

201
A priced hold on one slot and the summary to show the customer. Nothing is booked until create_booking.
Quote
404
No such id, or it is not visible to this key.
NotFound
409
The slot was taken or can no longer be booked: alternatives lists nearby openings.
SlotUnavailable

Search documentation

Businesses

Services

Staff

Resources

Slots

Quotes

Bookings

ScheduleOperator key

System

Guidance for apps and assistants

Headers

Body

Responses