ppq.com.au APIppq.com.au ↗
Check Queensland personalised plate availability, get pricing by design and range, and retrieve similar combination suggestions via the PPQ API.
curl -X POST 'https://api.parse.bot/scraper/38c41957-822c-4b80-8444-25c0c70930b7/check_availability' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'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.
| Param | Type | Description |
|---|---|---|
| combinationrequired | string | The plate combination to check, 1-7 alphanumeric characters (letters and numbers only). Automatically converted to uppercase. |
| vehicle_type_id | string | Vehicle type ID. Accepts: 1 (Motor Vehicle), 2 (Trailer), 3 (Motor Cycle), 4 (Small Trailer). |
{
"type": "object",
"fields": {
"format": "string",
"reason": "string",
"too_wide": "boolean",
"available": "boolean",
"combination": "string",
"on_p2p_hold": "boolean",
"inappropriate": "boolean",
"default_design": "object containing plate design details including id, name, buy_price, delivery_days, foreground_colours, and combination_formats",
"availability_status": "integer",
"available_design_ids": "array of integer design IDs compatible with this combination",
"vehicle_type_suitable": "boolean"
},
"sample": {
"data": {
"format": "5",
"reason": "",
"too_wide": false,
"available": true,
"combination": "TEST1",
"on_p2p_hold": false,
"inappropriate": false,
"default_design": {
"id": 171,
"name": "Framed Prestige - Black",
"buy_price": 2500,
"delivery_days": 10,
"can_have_space": true,
"can_have_caption": false,
"can_change_colour": true,
"can_have_separator": false,
"foreground_colours": [
{
"name": "White",
"hex_value": "FFFFFF",
"colour_code": "WH"
}
],
"combination_formats": [
{
"id": 9,
"code": "6",
"tooltip": "This design allows 6 letters or numbers.",
"max_chars": 6
}
],
"background_colour_code": "BK"
},
"availability_status": 1,
"available_design_ids": [
171,
141,
147,
173,
174,
176
],
"vehicle_type_suitable": true
},
"status": "success"
}
}About the ppq.com.au API
The PPQ API exposes 3 endpoints that cover personalised number plate availability, pricing, and suggestions on ppq.com.au. The check_availability endpoint returns a 10-field response including availability status, default design buy price, compatible design IDs, and flags for inappropriate or over-width combinations. All endpoints accept a plate combination of up to 7 alphanumeric characters and an optional vehicle type ID.
Availability and Design Data
The check_availability endpoint accepts a combination string (1–7 alphanumeric characters, automatically uppercased) and an optional vehicle_type_id (1 = Motor Vehicle, 2 = Trailer, 3 = Motor Cycle, 4 = Small Trailer). It returns an available boolean, an availability_status integer, and a default_design object containing the plate's buy_price, delivery_days, foreground_colours, and combination_formats. It also surfaces on_p2p_hold, inappropriate, and too_wide flags — useful for pre-validating combinations before presenting them to a user.
Plate Ranges and Pricing
get_plate_ranges returns the full set of product categories available for a given combination. Each entry in the plate_ranges array includes id, name, purchase_from_price, available, plate_design_count, and a tooltip. The endpoint also returns a combination_formats array with per-format pricing (price_from) and max_chars, and a vehicle_types array with availability per type. This endpoint resolves faster than check_availability and is suited for building pricing grids or filter UIs.
Suggestions
The get_suggestions endpoint returns an array of alternative combinations ranked by score and levenshtein_distance relative to the query combination. Each suggestion includes available, priced_from, design_price, and format_name — enough to display ranked alternatives with pricing in a search results context.
- Check whether a specific Queensland plate combination is available before directing a user to purchase
- Display starting prices across all plate ranges and designs for a given combination
- Build a plate search tool that surfaces ranked alternatives when a user's first choice is unavailable
- Filter plate options by vehicle type (motor vehicle, trailer, motorcycle, small trailer) using vehicle_type_id
- Validate a combination for inappropriate content or excessive width before submission using the check_availability flags
- Show per-format pricing differences (combination_formats price_from) to help users choose a plate style
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.