List bookings

List the bookings your app created

GET/v1/bookings

curl 'https://www.yovamos.com/v1/bookings?customerEmail=sam%40example.com&limit=1' \
  -H "Authorization: Bearer $VAMOS_API_KEY"

{
  "bookings": [
    {
      "id": "bkg_bk000001",
      "status": "confirmed",
      "business": {
        "id": "biz_1v8g0yh11jl8ti",
        "name": "The Spot Barbershop",
        "timezone": "America/Los_Angeles"
      },
      "service": {
        "id": "svc_1wwvyo2007ynbx",
        "name": "Haircut"
      },
      "staff": {
        "id": "stf_0ngvtdm17z44qf",
        "name": "Marcus"
      },
      "startsAt": "2027-01-12T17:00:00Z",
      "endsAt": "2027-01-12T17:45:00Z",
      "local": "Tue, Jan 12 · 9:00–9:45 AM PST",
      "durationMinutes": 45,
      "partySize": 1,
      "price": {
        "amountMinor": 3500,
        "currency": "USD",
        "display": "$35.00"
      },
      "customer": {
        "name": "Sam Rivera",
        "email": "sam@example.com"
      },
      "source": "Dots",
      "consent": {
        "statement": "Yes, book it.",
        "at": "2027-01-11T21:40:12.000Z"
      },
      "manageUrl": "https://www.yovamos.com/booking/manage?booking=bkg_bk000001",
      "createdAt": "2027-01-11T21:40:12.000Z",
      "next": [
        "Tell the customer the booking is confirmed."
      ],
      "untrusted": [
        "business.name",
        "service.name",
        "staff.name",
        "customer.name",
        "consent.statement"
      ]
    }
  ]
}

Headers

AuthorizationBearer tokenRequired
Your app key. Authentication

Query parameters

customerEmailstring (up to 254 characters)
Only bookings for this customer email.
partnerRefstring (up to 64 characters)
Only bookings you created with this partnerRef.
statuspendingconfirmeddeclinedcanceledexpiredcompletedno_show
pending: waiting for the business to approve the request. confirmed: locked in. declined: the business said no (see approval.note). canceled: canceled by the customer, by the business or by the system (see cancellation). expired: the business did not answer in time. completed/no_show: after the appointment.
limitinteger (1–50)
Maximum bookings to return (1-50, default 20).

Responses

200
A page of bookings, newest first. Follow nextCursor for more.
BookingPage

Search documentation

Businesses

Services

Staff

Resources

Slots

Quotes

Bookings

ScheduleOperator key

System

Guidance for apps and assistants

Headers

Query parameters

Responses