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

> Browse and search car listings from Autochek Kenya's marketplace, view detailed vehicle information including specs and pricing, explore available makes and models, and get instant loan eligibility estimates for your purchase. Discover popular cars, brand new inventory, and connect with dealers all in one place.

**Category:** Automotive | **Website:** [autochek.africa/](https://autochek.africa/) | **Docs:** [parse.bot/marketplace/c7178412-8eb8-4835-8806-a27d271f17b1/autochek-africa-api](https://parse.bot/marketplace/c7178412-8eb8-4835-8806-a27d271f17b1/autochek-africa-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/autochek/`
**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 brand new cars

Retrieve brand new car listings available in Kenya with pagination. Returns new-condition vehicles from authorized dealers.

**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/autochek/get-brand-new-cars \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get car listing detail

Retrieve full details of a specific car listing by its vehicle ID. Returns car specifications (year, mileage, transmission, colors), features, media gallery, financing calculator settings, similar cars, and inspection data. Returns stale_input if the listing no longer exists.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vehicle_id` | string | Yes | The vehicle ID (e.g. '8oxhDwkYe'). Obtain from search_car_listings results[*].id. |

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

### Get car loan eligibility

Estimate car loan monthly repayment based on car value, down payment percentage, and tenure. Uses a 21% annual interest rate. Pure computation — no upstream call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `car_value` | number | Yes | Total car value in KES. |
| `down_payment_pct` | number | Yes | Down payment as a decimal between 0 and 1 exclusive (e.g. 0.3 for 30%). |
| `tenure_months` | integer | Yes | Loan tenure in months (e.g. 36, 48, 60). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/autochek/get-car-loan-eligibility \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"car_value":"<number>","down_payment_pct":"<number>","tenure_months":"<integer>"}'
```

### Get car makes brands

Retrieve the complete list of all car makes/brands available on the platform. Returns up to 1000 makes in a single page with brand name and optional logo URL.

**Estimated cost:** Metered

_No parameters required._

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

### Get car models by make

Retrieve all car models available for a specific brand/make that have inventory in Kenya. Returns model name, wheel type, and popularity flag.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make_id` | string | Yes | The make/brand ID from get_car_makes_brands makeList[*].id (e.g. '106' for Toyota). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/autochek/get-car-models-by-make \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"make_id":"<string>"}'
```

### Get dealers

Retrieve list of car dealers available on the platform. Returns dealer brand, location, and inventory counts.

**Estimated cost:** Metered

_No parameters required._

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

### Get popular cars

Retrieve popular car listings shown on the homepage. Returns the most recent popular listings with pagination metadata. Useful for discovering trending vehicles.

**Estimated cost:** Metered

_No parameters required._

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

### Search car listings

Full-text search and filter over used car listings in Kenya. Supports filtering by make, model, year, and price range. Paginates via page number; each page returns up to 23 listings. Returns car summaries with pricing, mileage, and condition metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `make` | string | No | Car make/brand filter (e.g. 'Toyota', 'BMW', 'Nissan'). |
| `max_price` | integer | No | Maximum price filter in KES. |
| `min_price` | integer | No | Minimum price filter in KES. |
| `model` | string | No | Car model filter (e.g. 'Corolla', 'X1'). |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword to match against listing titles. |
| `year` | integer | No | Manufacture year filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/autochek/search-car-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","max_price":"<integer>","min_price":"<integer>","model":"<string>","page":"<integer>","query":"<string>","year":"<integer>"}'
```

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