# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/telgani/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/telgani/get-special-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/telgani/list-car-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/telgani/list-car-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/telgani/list-cities \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/telgani/search-cars \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/telgani/search-cars-subscription \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"city_name":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.