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

> Search for rental cars across multiple cities and filter by brand or type to find the perfect vehicle. Discover special offers, compare pricing, and explore subscription plans on Telgani.

**Category:** Travel | **Website:** [telgani.com/](https://telgani.com/) | **Docs:** [parse.bot/marketplace/95b91a3a-d044-408a-9a9c-d0cb44daa81c/telgani-com-api](https://parse.bot/marketplace/95b91a3a-d044-408a-9a9c-d0cb44daa81c/telgani-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-telgani-com-api-95b91a3a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_special_offers

Retrieve cars with active special offers or discounts. Returns cars whose discount_price is lower than their regular price. Uses the same car response shape as search_cars. Paginates internally.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telgani-com-api-95b91a3a/get_special_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_car_brands

Retrieve all car manufacturers and brands available on the platform. Returns a flat list of brand identifiers and display names. The full catalog is returned in one response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telgani-com-api-95b91a3a/list_car_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_car_types

Retrieve all car type categories offered on the platform (SUV, Economy, Sedan, Luxury, etc.). Returns a flat list of type identifiers and display names in one response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telgani-com-api-95b91a3a/list_car_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_cities

Retrieve all cities and locations where Telgani offers car rental services. Each city includes coordinates and a slug for use in other endpoints. The full list is returned in a single response with no pagination.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telgani-com-api-95b91a3a/list_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_cars

Search for available rental cars by city, coordinates, and rental dates. Paginates internally up to the specified limit. Each car includes daily pricing, office details, subscription availability, and installment options. Defaults to Riyadh with tomorrow/day-after-tomorrow dates when no location or dates are provided.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_name` | string | No | City name to search in (e.g. 'Riyadh', 'Jeddah', 'Dammam'). If omitted and no coordinates provided, defaults to Riyadh. |
| `drop_date` | string | No | Drop-off date in YYYY-MM-DD format. Defaults to day after tomorrow if omitted. |
| `lat` | number | No | Latitude coordinate for the search location. |
| `limit` | integer | No | Maximum number of car results to return. |
| `lng` | number | No | Longitude coordinate for the search location. |
| `pickup_date` | string | No | Pick-up date in YYYY-MM-DD format. Defaults to tomorrow if omitted. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telgani-com-api-95b91a3a/search_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_name":"<string>","drop_date":"<string>","lat":"<number>","limit":"<integer>","lng":"<number>","pickup_date":"<string>"}'
```

### search_cars_subscription

Search for cars available for monthly or yearly subscription plans. Returns cars with subscription pricing broken down by duration (1, 3, 6, 9, 12 months). Defaults to Riyadh if no city is specified.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city_name` | string | No | City name to filter subscription cars (e.g. 'Riyadh', 'Jeddah', 'Dammam'). If omitted, defaults to Riyadh. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-telgani-com-api-95b91a3a/search_cars_subscription \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city_name":"<string>"}'
```