# Lyft — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Check real-time Lyft availability across cities, compare ride types and pricing, and see estimated arrival times for nearby drivers. Get detailed information about Lyft's service areas and instantly calculate trip costs before you book.

**Category:** Travel | **Website:** [lyft.com/](https://lyft.com/) | **Docs:** [parse.bot/marketplace/5830de95-6527-4164-afd7-167aae9388ae/lyft-com-api](https://parse.bot/marketplace/5830de95-6527-4164-afd7-167aae9388ae/lyft-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-lyft-com-api-5830de95/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_cities

Returns the complete directory of cities where Lyft operates, organized by country code (US, CA). Each country contains an array of states/provinces, each with an array of cities carrying a display name and a slug usable with get_city_details. The response is a single directory object, not a paginated list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lyft-com-api-5830de95/get_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_city_details

Returns details about a specific Lyft city including its region code, service area geometry (GeoJSON), available ride type flags, and pricing disclaimers. The slug parameter comes from the get_cities directory.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | City slug from get_cities results (e.g. 'los-angeles-ca', 'phoenix-az', 'birmingham-al') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lyft-com-api-5830de95/get_city_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_nearby_drivers

Returns availability and estimated costs for each ride type at a given location. Shows which ride types are currently available, their ETA in seconds, and min/max cost range in cents. Coordinates should be within a Lyft service area.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lat` | number | Yes | Latitude of the location |
| `lng` | number | Yes | Longitude of the location |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lyft-com-api-5830de95/get_nearby_drivers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lat":"<number>","lng":"<number>"}'
```

### get_ride_estimates

Returns price and duration estimates for all available ride types between two geographic points. Each estimate includes min/max cost in cents and estimated duration in seconds. Coordinates should be within a Lyft service area for valid estimates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `end_lat` | number | Yes | Destination latitude |
| `end_lng` | number | Yes | Destination longitude |
| `start_lat` | number | Yes | Pickup latitude |
| `start_lng` | number | Yes | Pickup longitude |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lyft-com-api-5830de95/get_ride_estimates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_lat":"<number>","end_lng":"<number>","start_lat":"<number>","start_lng":"<number>"}'
```