Delivery
Move a package between two points, with no merchant involved. The quote runs the same pricing path the request does, so the price you are shown is the price charged.
Move a package between two points, with no merchant involved. The quote runs the same pricing path the request does, so the price you are shown is the price charged.
Lifecycle
QUOTED
|
CREATED
|
COURIER ASSIGNED
|
PICKED UP
|
DELIVERED (or CANCELLED, before pickup)Operations
POST /v1/deliveries/quote
Coming soon Sandbox supported
Price a courier run between two points. Runs the same pricing path the request does, so the quote is the charge.
| Operation | quote_delivery |
|---|---|
| Scope | delivery.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | quote_delivery |
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/deliveries/quote' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-d '{ … }'POST /v1/deliveries
Coming soon Ryde One required Sandbox supported
Dispatch a courier to move a package, from a quote_id the customer was shown.
| Operation | request_delivery |
|---|---|
| Scope | delivery.request |
| Entitlement | Ryde One required |
| Idempotency | Required |
| MCP tool | request_delivery |
Requires a fresh quote the customer was shown, plus an Idempotency-Key.
Example request
curl -sX POST 'https://sandbox-api.ryde.us.com/v1/deliveries' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN" \
-H "Idempotency-Key: $(uuidgen)" \
-H 'Content-Type: application/json' \
-d '{ … }'GET /v1/deliveries/{delivery_id}
Coming soon Sandbox supported
Live state of one delivery, including courier progress and proof of delivery once collected.
| Operation | get_delivery |
|---|---|
| Scope | delivery.read |
| Entitlement | None |
| Idempotency | Not required |
| MCP tool | get_delivery |
Example request
curl -s 'https://sandbox-api.ryde.us.com/v1/deliveries/$delivery_id' \
-H "Authorization: Bearer $RYDE_ACCESS_TOKEN"