Lyft
  1. User
Lyft
  • Public
    • Cost estimates
      GET
    • Available drivers nearby
      GET
    • Pickup ETAs
      GET
    • Types of rides
      GET
  • User
    • The user's general info
      GET
    • List rides
      GET
    • Request a Lyft
      POST
    • Get the ride detail of a given ride ID
      GET
    • Cancel a ongoing requested ride
      POST
    • Update the destination of the ride
      PUT
    • Add the passenger's rating, feedback, and tip
      PUT
    • Get the receipt of the rides.
      GET
  • Sandbox
    • Preset Prime Time percentage
      PUT
    • Propagate ride through ride status
      PUT
    • Preset types of rides for sandbox
      PUT
    • Driver availability for processing ride request
      PUT
  1. User

List rides

GET
/rides
Get a list of past & current rides for this passenger.
Request Request Example
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
curl --location --request GET 'https://api.lyft.com/v1/rides?start_time='
Response Response Example
200 - Example 1
{
    "ride_history": [
        {
            "beacon_color": "#FFFFFF",
            "destination": {
                "address": "987 Second St, Anytown, CA",
                "lat": 36.9453452,
                "lng": -123.8642521
            },
            "distance_miles": 16.2,
            "driver": {
                "first_name": "Joe",
                "image_url": "http://example.com/lyft.png",
                "phone_number": "+15554445111",
                "rating": "4.9"
            },
            "dropoff": {
                "address": "987 Second St, Anytown, CA",
                "lat": 36.9453452,
                "lng": -123.8642521,
                "time": "2023-08-15T05:38:32.975Z"
            },
            "duration_seconds": 1620,
            "line_items": [
                {
                    "amount": 500,
                    "currency": "USD",
                    "type": "Ride"
                },
                {
                    "amount": 250,
                    "currency": "USD",
                    "type": "Prime Time"
                },
                {
                    "amount": 155,
                    "currency": "USD",
                    "type": "Service fee"
                }
            ],
            "location": {
                "address": "987 Second St, Anytown, CA",
                "lat": 36.9453452,
                "lng": -123.8642521
            },
            "origin": {
                "address": "123 Main St, Anytown, CA",
                "lat": 36.9442175,
                "lng": -123.8679133
            },
            "passenger": {
                "first_name": "Jane",
                "phone_number": "+15554445000",
                "user_id": "776630198662493392"
            },
            "pickup": {
                "address": "123 Main St, Anytown, CA",
                "lat": 36.9442175,
                "lng": -123.8679133,
                "time": "2023-08-15T05:38:32.975Z"
            },
            "price": {
                "amount": 905,
                "currency": "USD",
                "description": "Total ride price"
            },
            "primetime_percentage": "50%",
            "requested_at": "2023-08-15T05:38:32.975Z",
            "ride_id": 123456789,
            "ride_profile": "personal",
            "ride_type": "lyft",
            "status": "droppedOff",
            "vehicle": {
                "color": "black",
                "image_url": "http://example.com/lyft.png",
                "license_plate": "AAAAAAA",
                "make": "Audi",
                "model": "A4"
            }
        }
    ]
}

Request

Query Params

Responses

🟢200An object with an array of up to `limit` rides taken by the user between `start_time` and `end_time`.
application/json
Body

🟠400A validation error occurred
Modified at almost 2 years ago
Previous
The user's general info
Next
Request a Lyft
Built with