# Uber — 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.

> Plan your Uber rides by searching nearby pickup locations, getting real-time distance and arrival time estimates, and looking up detailed place information. Get all the information you need to book with confidence before requesting your ride.

**Category:** Maps & Geospatial | **Website:** [uber.com/](https://uber.com/) | **Docs:** [parse.bot/marketplace/34012efa-375e-4bc5-b249-35b222bd3a36/uber-com-api](https://parse.bot/marketplace/34012efa-375e-4bc5-b249-35b222bd3a36/uber-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-uber-com-api-34012efa/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_place_details

Get detailed place information including full address, coordinates, and address components from a place ID obtained via search_locations. The returned coordinates can be used with get_ride_estimate or get_ride_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `place_id` | string | Yes | Uber place ID from search_locations results (e.g. '32b3a157-8e07-3215-ab38-7c080b9219a5'). |
| `place_type` | string | No | Type of place usage. Accepts exactly: destination, pickup. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uber-com-api-34012efa/get_place_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"place_id":"<string>","place_type":"<string>"}'
```

### get_ride_estimate

Get route distance and estimated travel time (ETA) between pickup and dropoff coordinates. Use search_locations and get_place_details to obtain coordinates for addresses. Returns distance in both meters and miles, and ETA in both seconds and minutes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dropoff_latitude` | string | Yes | Latitude of the dropoff location as a decimal number (e.g. '40.6413'). |
| `dropoff_longitude` | string | Yes | Longitude of the dropoff location as a decimal number (e.g. '-73.7781'). |
| `pickup_latitude` | string | Yes | Latitude of the pickup location as a decimal number (e.g. '40.7580'). |
| `pickup_longitude` | string | Yes | Longitude of the pickup location as a decimal number (e.g. '-73.9855'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uber-com-api-34012efa/get_ride_estimate \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dropoff_latitude":"<string>","dropoff_longitude":"<string>","pickup_latitude":"<string>","pickup_longitude":"<string>"}'
```

### get_ride_products

Get available Uber ride products (vehicle types) for a given location. Returns product details including name, description, passenger capacity, tier, and vehicle image URL. Use coordinates from get_place_details or known latitude/longitude values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latitude` | string | No | Latitude of the location to check product availability (e.g. '40.7580'). |
| `longitude` | string | No | Longitude of the location to check product availability (e.g. '-73.9855'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uber-com-api-34012efa/get_ride_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":"<string>","longitude":"<string>"}'
```

### search_locations

Search for locations by name or address within a geographic context. Returns a list of matching places with IDs usable with get_place_details to retrieve coordinates. Results are biased toward the provided latitude/longitude.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `latitude` | string | No | Latitude of the search context area. Results are biased toward this location. |
| `longitude` | string | No | Longitude of the search context area. Results are biased toward this location. |
| `query` | string | Yes | Address or place name to search for (e.g. 'Times Square', 'JFK Airport', '123 Main St'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-uber-com-api-34012efa/search_locations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":"<string>","longitude":"<string>","query":"<string>"}'
```