Book an appointment

Request

Books a new appointment for a patient. Billing type determines payment requirements — bill-to-patient appointments require a valid Stripe paymentMethod ID collected via the setup intent flow. Bill-to-account falls back to the account card on file. Monthly invoice requires no payment method.

Security

BearerAuth

Bodyapplication/jsonrequired

addressstringrequired

Example:"123 Main St"

citystringrequired

Example:"Phoenix"

statestringrequired

Example:"AZ"

zipstringrequired

Example:"85003"

patientIdintegerrequired

Example:1

billingTypestringrequired

Enum:"Bill to Patient""Bill to Account""Monthly Invoice"

Example:"Bill to Patient"

paymentMethodstring

Stripe payment method ID. Required when billingType is "Bill to Patient".

Example:"pm_1TOn5vKR1SKMkoDmhkksYv2S"

appointmentDateTimestring, (date-time)required

Example:"2026-04-29T16:00:00.000Z"

serviceIdintegerrequired

Example:1

notesstring

Example:"Patient prefers morning appointments."

curl -i -X POST \
  https://docs.speedysticks.com/_mock/openapi/api/appointment \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "123 Main St",
    "city": "Phoenix",
    "state": "AZ",
    "zip": "85003",
    "patientId": 1,
    "billingType": "Bill to Patient",
    "paymentMethod": "pm_1TOn5vKR1SKMkoDmhkksYv2S",
    "appointmentDateTime": "2026-04-29T16:00:00.000Z",
    "serviceId": 1,
    "notes": "Patient prefers morning appointments."
  }'

Responses

Appointment booked successfully.

Bodyapplication/json

idinteger

Example:1

appointmentDateTimestring, (date-time)

Example:"2024-01-15T09:00:00Z"

appointmentTimeZonestring

Example:"America/New_York"

pricenumber, (decimal)

Example:150

statusstring

Enum:"Pending""In Progress""Completed""Canceled""Denied"

Example:"Pending"

notesstring or null

Example:"Patient requested morning appointment"

addressstring

Example:"123 Main St"

citystring

Example:"Phoenix"

statestring

Example:"AZ"

zipstring

Example:"85003"

billingTypestring

Enum:"Monthly Invoice""Bill to Patient""Bill to Account"

Example:"Bill to Patient"

Response

{
  "id": 1,
  "appointmentDateTime": "2024-01-15T09:00:00Z",
  "appointmentTimeZone": "America/New_York",
  "price": 150,
  "status": "Pending",
  "notes": "Patient requested morning appointment",
  "address": "123 Main St",
  "city": "Phoenix",
  "state": "AZ",
  "zip": "85003",
  "billingType": "Bill to Patient"
}