# Personalised Plates Queensland — 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 available personalised number plates in Queensland, check pricing for different plate designs and ranges, and discover similar plate combinations to help you find your perfect custom plate. Browse all available options on ppq.com.au without visiting the site directly.

**Category:** Government & Public Data | **Website:** [ppq.com.au/](https://ppq.com.au/) | **Docs:** [parse.bot/marketplace/43f05e0a-ee69-43a7-9a9f-4a3c63817056/ppq-com-au-api](https://parse.bot/marketplace/43f05e0a-ee69-43a7-9a9f-4a3c63817056/ppq-com-au-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-ppq-com-au-api-43f05e0a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### check_availability

Check whether a specific plate combination is available for purchase in Queensland. Returns availability status, the default plate design with its buy price, available colour options, and a list of all compatible design IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `combination` | string | Yes | The plate combination to check, 1-7 alphanumeric characters (letters and numbers only). Automatically converted to uppercase. |
| `vehicle_type_id` | string | No | Vehicle type ID. Accepts: 1 (Motor Vehicle), 2 (Trailer), 3 (Motor Cycle), 4 (Small Trailer). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ppq-com-au-api-43f05e0a/check_availability \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"combination":"<string>","vehicle_type_id":"<string>"}'
```

### get_plate_ranges

Get available plate ranges (product categories) with starting prices, combination format options with pricing, and vehicle type information for a given plate combination. Does not require reCAPTCHA solving, making it faster than check_availability.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `combination` | string | Yes | The plate combination to get ranges for, 1-7 alphanumeric characters. Automatically converted to uppercase. |
| `vehicle_type_id` | string | No | Vehicle type ID. Accepts: 1 (Motor Vehicle), 2 (Trailer), 3 (Motor Cycle), 4 (Small Trailer). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ppq-com-au-api-43f05e0a/get_plate_ranges \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"combination":"<string>","vehicle_type_id":"<string>"}'
```

### get_suggestions

Get alternative plate combination suggestions similar to the input combination. Returns suggested combinations with availability status, pricing (priced_from and design_price), similarity scores, and format information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `combination` | string | Yes | The plate combination to find suggestions for, 1-7 alphanumeric characters. Automatically converted to uppercase. |
| `vehicle_type_id` | string | No | Vehicle type ID. Accepts: 1 (Motor Vehicle), 2 (Trailer), 3 (Motor Cycle), 4 (Small Trailer). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ppq-com-au-api-43f05e0a/get_suggestions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"combination":"<string>","vehicle_type_id":"<string>"}'
```