Get scheduled booking

One booking at the business

GET/v1/operator/schedule/{bookingId}

curl 'https://www.yovamos.com/v1/operator/schedule/bkg_bk000005' \
  -H "Authorization: Bearer $VAMOS_OPERATOR_KEY"

{
  "id": "bkg_bk000005",
  "status": "pending",
  "business": {
    "id": "biz_0bgwx751b581z6",
    "name": "Flow Wellness Studio",
    "timezone": "America/Chicago"
  },
  "service": {
    "id": "svc_1gwr95x0flmiq6",
    "name": "Deep Tissue Massage"
  },
  "staff": {
    "id": "stf_1vihc0v104zdgo",
    "name": "Joy"
  },
  "startsAt": "2027-01-12T15:00:00Z",
  "endsAt": "2027-01-12T16:00:00Z",
  "local": "Tue, Jan 12 · 9:00–10:00 AM CST",
  "durationMinutes": 60,
  "partySize": 1,
  "price": {
    "amountMinor": 9500,
    "currency": "USD",
    "display": "$95.00"
  },
  "customer": {
    "name": "Sam Rivera",
    "email": "sam@example.com",
    "isFirstBooking": true
  },
  "source": "Dots",
  "approval": {
    "state": "pending",
    "requestedAt": "2027-01-11T21:40:12.000Z",
    "expiresAt": "2027-01-11T22:40:12Z",
    "expiresAtLocal": "Mon, Jan 11 · 4:40 PM CST",
    "reasons": [
      "This business reviews every request from apps."
    ]
  },
  "consent": {
    "statement": "Yes, book it.",
    "at": "2027-01-11T21:40:12.000Z"
  },
  "manageUrl": "https://www.yovamos.com/booking/manage?booking=bkg_bk000005",
  "createdAt": "2027-01-11T21:40:12.000Z",
  "next": [
    "This request is waiting for your decision until Mon, Jan 11 · 4:40 PM CST. Call approve_booking to confirm it or decline_booking (with a note the customer will read) to release the slot."
  ],
  "untrusted": [
    "business.name",
    "service.name",
    "staff.name",
    "customer.name",
    "consent.statement"
  ]
}

Headers

AuthorizationBearer tokenRequired
Your operator key. Authentication

Path parameters

bookingIdstringRequired
Booking id as returned by create_booking (prefix bkg_).

Responses

200
A booking: its status, time, price, the customer's consent record and what to do next.
Booking
403
The key is valid but may not do this.
Forbidden
404
No such id, or it is not visible to this key.
NotFound

Search documentation

Businesses

Services

Staff

Resources

Slots

Quotes

Bookings

ScheduleOperator key

System

Guidance for apps and assistants

Headers

Path parameters

Responses