Pricing Estimator
Get repair cost predictions by VIN, vehicle specs, or market-matched category. All endpoints return itemised labour and parts breakdowns.
Configuration
Select your API key to authenticate all playground requests on this page.
Predict VIN Market Match
Get a repair cost prediction using a VIN and a standardised market repair category — no subcategory search needed.
POST /api/v1/predict
GET /api/v1/predict/categories/market-match
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
vin | string | Yes | 17-character Vehicle Identification Number. |
zip_code | string | Yes | US ZIP code for the repair location. |
mileage | integer | No | Current odometer reading. |
problem_identifier | string | Yes | Category ID (as string) from the market-match list endpoint. |
Example Request
curl -X POST https://dev.api.aiadmin.quickmechs.com/api/v1/predict \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vin":"1HGCM82633A004352","zip_code":"90210","mileage":85000,"problem_identifier":"7"}'Try it
Request
POST /api/v1/predict {}
Response
// Select a category and submit to see result
Predict by VIN
Get a repair cost prediction using a vehicle's VIN, zip code, and problem identifier.
POST /api/v1/predict
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
vin | string | Yes | 17-character VIN. First 11 chars used for vehicle lookup. |
zip_code | string | Yes | US ZIP code. Affects regional labour and parts pricing. |
mileage | integer | No | Current odometer reading in miles. |
problem_identifier | string | Yes | Sub-category slug or ID. |
Example Request
curl -X POST https://dev.api.aiadmin.quickmechs.com/api/v1/predict \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"vin":"1HGCM82633A004352","zip_code":"90210","mileage":85000,"problem_identifier":"brake-pad-replacement"}'Try it
Request
POST /api/v1/predict {}
Response
// Submit the form to see the prediction result
Predict by Vehicle Specs
Get a repair cost prediction by selecting year, make, model, trim, and engine — no VIN required.
POST /api/v1/predict/by-specs
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
year | integer | Yes | Vehicle model year. |
make | string | Yes | Vehicle manufacturer. |
model | string | Yes | Vehicle model. |
trim | string | No | Trim level. |
engine | string | No | Engine descriptor. |
zip_code | string | Yes | US ZIP code for regional pricing. |
problem_identifier | string | Yes | Sub-category slug or ID. |
Example Request
curl -X POST https://dev.api.aiadmin.quickmechs.com/api/v1/predict/by-specs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2019,"make":"Honda","model":"Accord","zip_code":"90210","problem_identifier":"brake-pad-replacement"}'Try it
Request
POST /api/v1/predict/by-specs {}
Response
// Select vehicle specs to get a prediction
Search Sub-categories
Search across all visible repair sub-categories by name. Returns matches with their parent category and ID.
POST /api/v1/predict/categories/search
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Free-text search term (e.g. "brake pad", "oil change"). |
limit | integer | No | Max results to return. Default: 10. Max: 50. |
Example Request
curl -X POST https://dev.api.aiadmin.quickmechs.com/api/v1/predict/categories/search \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"brake pad","limit":10}'Try it
Minimum 2 characters. Returns up to 20 results.
Request
POST /api/v1/predict/categories/search {}
Response
// Type a search query to find sub-categories
Describe Sub-category
Get an AI-generated description of what a repair sub-category involves. Descriptions are cached after first generation.
POST /api/v1/predict/categories/{id}/describe
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Path param. Sub-category ID from the search endpoint. |
Example Request
curl -X POST https://dev.api.aiadmin.quickmechs.com/api/v1/predict/categories/7/describe \
-H "Authorization: Bearer YOUR_API_KEY"Try it
Request
POST /api/v1/predict/categories/{id}/describe
Response
// Select a sub-category to get its AI description