Guest Rides API Resource
¶ Overview
Uber’s Guest Rides API provides a way to manage transportation for your guests via the Uber Platform.
Your guests are not required to have an Uber account, but you will need to provide some guest details when requesting a ride.
| Field | URL |
|---|---|
Production API root URL |
https://api.uber.com/v1/guests/ |
Sandbox API root URL |
https://sandbox-api.uber.com/v1/guests/ |
| Field | URL |
|---|---|
Production |
Production Postman API collection |
Sandbox |
Sandbox Postman API collection |
Sandbox |
Guest Rides Sandbox Scenarios |
Note: Please read overview section for instructions on how to run collection.
Your application must have the guests.trips scope to use either of the production or sandbox resources.
Note: The default rate limit for each end-point is 200 per hour. This can be increased as per the business needs.
¶ Developer Guides
- Authentication - Authentication for the Guest Rides API is done using OAuth 2.0 client credentials using the
guest.ridesscope. - Errors - There are different errors that may need to be handled in different ways.
- Sandbox - The Sandbox can be used to test endpoints without actually requesting a trip.
- Webhooks - Setup a webhook to receive data from the Uber Platform.
¶ Available Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/guests/trips/{} | Retrieve the details of a specific trip. |
| GET | /v1/guests/trips | Retrieve trip details for a set of trips. |
| GET | /v1/guests/trips/{}/receipt | Retrieve a receipt of a past trip. |
| POST | /v1/guests/trips | Request a trip. |
| DELETE | /v1/guests/trips/{} | Cancel a trip. |
| POST | /v1/guests/trips/estimates | Retrieve available products and corresponding price estimates for a route from one location to another. |
| POST | /v1/guests/trips/call | Initiates a call between the given phone number and the driver of the given trip id. |
| POST | /v1/guests/trips/tip | Add a tip to a completed trip. |
| GET | /v1/guests/zones | Retrieves a list of zones corresponding to specialized pickup locations. |
| PUT | /v1/guests/trips/communication | Create or update a communication session with the driver for a trip. |
| POST | /v1/guests/trips/{}/message | Send a message to the driver of an active trip. |
| PUT | /v1/guests/trips | Update an active trip. |
| GET | /v1/guests/guests/phone-info/ | Retrieves guests rider phone information. |
| POST | /v1/guests/trips/{}/dispatch | Dispatch a flexible trip. |
| POST | /v1/trips/products-info | Retrieves products information. |
| GET | /v1/guests/address/autocomplete | Address autocomplete |