# Cheki — 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 and browse vehicles on Cheki Kenya's automotive marketplace, view detailed information about specific cars, and discover dealer profiles and inventory. Filter your vehicle search by available metadata to find exactly what you're looking for.

**Category:** Automotive | **Website:** [cheki.co.ke/](https://cheki.co.ke/) | **Docs:** [parse.bot/marketplace/caa895a8-4a84-49e4-b3a3-75a8fe47e439/cheki-co-ke-api](https://parse.bot/marketplace/caa895a8-4a84-49e4-b3a3-75a8fe47e439/cheki-co-ke-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/cheki/`
**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 dealer profile

Get a specific dealer's profile details including name, membership date, description, and rating. The slug is obtained from list_dealers results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Dealer slug from list_dealers results (e.g. 'benjamin-mutua'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cheki/get-dealer-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### Get search filters metadata

Retrieve available filter options for vehicle search. Returns lists of makes, conditions, body types, and year ranges with their values and labels. Use the returned values as inputs to search_vehicles filters.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cheki/get-search-filters-metadata \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get vehicle detail

Get full details for a single vehicle listing by its slug. Returns structured data including specs, description, features, seller info, and images extracted from the listing's JSON-LD metadata. The slug is obtained from search_vehicles results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Vehicle listing slug from search_vehicles results (e.g. 'toyota-passo-2019-petrol'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cheki/get-vehicle-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### List dealers

List registered car dealers on cheki.co.ke. Returns dealer names, slugs, membership dates, and description snippets. Paginates by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cheki/list-dealers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Search vehicles

Search for vehicles on cheki.co.ke using various filters. Returns a paginated list of vehicle cards with title, price, slug, specs, and condition. At least one filter or no filters returns all available listings. Paginates by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `body_type` | string | No | Body type filter slug. Accepted values: 'SUVs', 'Saloons', 'Hatchbacks', 'Pickups', 'Station Wagons', 'Mini-Van', 'Trucks', 'Bus', 'Bike', 'Others'. |
| `condition` | string | No | Vehicle condition filter. Accepted values: 'Fresh Import', 'Locally Used', 'New'. |
| `keyword` | string | No | Free-text search keyword (e.g. 'Prado', 'V8'). |
| `make` | string | No | Vehicle make/brand slug (e.g. 'toyota', 'nissan', 'bmw'). Use values from get_search_filters_metadata. |
| `max_price` | string | No | Maximum price in KES as a numeric string (e.g. '5000000'). |
| `min_price` | string | No | Minimum price in KES as a numeric string (e.g. '500000'). |
| `page` | integer | No | Page number for pagination. |
| `year_from` | string | No | Minimum year of manufacture (e.g. '2010'). |
| `year_to` | string | No | Maximum year of manufacture (e.g. '2025'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/cheki/search-vehicles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"body_type":"<string>","condition":"<string>","keyword":"<string>","make":"<string>","max_price":"<string>","min_price":"<string>","page":"<integer>","year_from":"<string>","year_to":"<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.