Services
Find providers who travel to the customer, read their real availability, and book a slot. Availability is derived per request from the provider's live state and posted schedule — never cached by the client, because a provider who has just taken a job is no longer available.
Find providers who travel to the customer, read their real availability, and book a slot. Availability is derived per request from the provider's live state and posted schedule — never cached by the client, because a provider who has just taken a job is no longer available.
Lifecycle
QUOTED
|
REQUESTED or SCHEDULED (booked into a specific slot)
|
ACCEPTED (or rejected by the provider)
|
ON THE WAY
|
IN PROGRESS (some providers require the customer to
| sign a liability waiver before starting)
COMPLETED (or CANCELLED, before work begins)Operations
GET /v1/services/providers
Coming soon Sandbox supported
Find providers who travel to the customer, with their live availability. Availability is derived per request and is never cached by the client.
| Operation | search_service_providers |
|---|---|
| Scope | services.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | search_service_providers |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/services/providers' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"GET /v1/services/providers/{provider_id}/slots
Coming soon Sandbox supported
Open appointment slots on a date, for a job of a given duration. A long job is only offered a start whose consecutive slots are all free.
| Operation | get_provider_availability |
|---|---|
| Scope | services.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | get_provider_availability |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/services/providers/$provider_id/slots' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"POST /v1/services/bookings/quote
Coming soon Sandbox supported
Price a service booking before committing to a slot.
| Operation | quote_service |
|---|---|
| Scope | services.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | quote_service |
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/services/bookings/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/services/bookings
Coming soon Ryde One required Sandbox supported
Book a provider, optionally into a specific slot. Slot contention is settled by the platform: a losing booking is refused, never double-booked.
| Operation | book_service |
|---|---|
| Scope | services.book |
| Entitlement | Ryde One required |
| Idempotency | Required |
| MCP tool | book_service |
Requires a fresh quote the customer was shown, plus an Idempotency-Key.
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/services/bookings' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/services/bookings/{booking_id}
Coming soon Sandbox supported
Live state of one booking, through arrival, start and completion.
| Operation | get_service_booking |
|---|---|
| Scope | services.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | get_service_booking |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/services/bookings/$booking_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"