# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-autochek-africa-api-c7178412/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-autochek-africa-api-c7178412/get_brand_new_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/get_car_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/get_car_loan_eligibility \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/get_car_makes_brands \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/get_car_models_by_make \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/get_dealers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/get_popular_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-autochek-africa-api-c7178412/search_car_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"make":"<string>","max_price":"<integer>","min_price":"<integer>","model":"<string>","page":"<integer>","query":"<string>","year":"<integer>"}'
```