Lyft (version v1.*.*)

cancel_ride

Cancel a ongoing ride which was requested earlier by providing the ride id.

Parameters

id (required)

The ID of the ride

Type: string

$body

Type: object

{
  "cancel_confirmation_token" : "Token affirming the user accepts the cancellation fee. Required if a cancellation fee is in effect."
}

get_cost

Estimate the cost of taking a Lyft between two points.

Parameters

start_lat (required)

Latitude of the starting location

Type: number

start_lng (required)

Longitude of the starting location

Type: number

end_lat

Latitude of the ending location

Type: number

end_lng

Longitude of the ending location

Type: number

ride_type

ID of a ride type

Type: string

Potential values: lyft, lyft_line, lyft_plus, lyft_premier, lyft_lux, lyft_luxsuv

get_eta

The ETA endpoint lets you know how quickly a Lyft driver can come get you

Parameters

lat (required)

Latitude of a location

Type: number

lng (required)

Longitude of a location

Type: number

destination_lat

Latitude of destination location

Type: number

destination_lng

Longitude of destination location

Type: number

ride_type

ID of a ride type

Type: string

Potential values: lyft, lyft_line, lyft_plus, lyft_premier, lyft_lux, lyft_luxsuv

get_my_profile

This operation has no parameters

get_my_rides

Get a list of past & current rides for this passenger.

Parameters

start_time (required)

Restrict to rides starting after this point in time. The earliest supported date is 2015-01-01T00:00:00+00:00

Type: date-time

end_time

Restrict to rides starting before this point in time. The earliest supported date is 2015-01-01T00:00:00+00:00

Type: date-time

limit

The maximum number of rides to return. The default limit is 10 if not specified. The maximum allowed value is 50, an integer greater that 50 will return at most 50 results.

Type: integer

get_nearby_drivers

The drivers endpoint returns a list of nearby drivers' lat and lng at a given location.

Parameters

lat (required)

Latitude of a location

Type: number

lng (required)

Longitude of a location

Type: number

get_ride_information

Get the status of a ride along with information about the driver, vehicle and price of a given ride ID

Parameters

id (required)

The ID of the ride

Type: string

get_ride_receipt

Get the receipt information of a processed ride by providing the ride id. Receipts will only be available to view once the payment has been processed. In the case of canceled ride, cancellation penalty is included if applicable.

Parameters

id (required)

The ID of the ride

Type: string

get_ride_types

The ride types endpoint returns information about what kinds of Lyft rides you can request at a given location.

Parameters

lat (required)

Latitude of a location

Type: number

lng (required)

Longitude of a location

Type: number

ride_type

ID of a ride type

Type: string

Potential values: lyft, lyft_line, lyft_plus, lyft_premier, lyft_lux, lyft_luxsuv

request_ride

Request a Lyft come pick you up at the given location.

Parameters

$body

Ride request information

Type: object

{
  "origin" : { },
  "cost_token" : "A token that confirms the user has accepted current Prime Time and/or fixed price charges",
  "destination" : { },
  "ride_type" : "The ID of the ride type"
}

set_ride_destination

Add or update the ride's destination. Note that the ride must still be active (not droppedOff or canceled), and that destinations on Lyft Line rides can not be changed.

Parameters

id (required)

The ID of the ride

Type: string

$body

The coordinates and optional address of the destination

Type: object

{
  "lng" : "The longitude component of a location",
  "lat" : "The latitude component of a location",
  "address" : "A human readable address at/near the given location"
}

set_ride_rating

Add the passenger's 1 to 5 star rating of the ride, optional written feedback, and optional tip amount in minor units and currency. The ride must already be dropped off, and ratings must be given within 24 hours of drop off. For purposes of display, 5 is considered the default rating. When this endpoint is successfully called, payment processing will begin.

Parameters

id (required)

The ID of the ride

Type: string

$body

The rating and optional feedback

Type: object

{
  "feedback" : "The passenger's written feedback about this ride",
  "rating" : "The passenger's rating of this ride from 1 to 5",
  "tip" : { }
}