---
title: "Estimate Cost Endpoint"
method: GET
path: "/v1/trades/estimate"
tags: ["Contractor/Trade Pricing"]
---

# Estimate Cost Endpoint

`GET /v1/trades/estimate`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/trades/estimate`
- Auth: none declared. Required headers: `X-API-Key`

Estimate total job cost for a trade service at a location.

## Query parameters

- `trade` string, required: Trade slug — get slugs from `GET /v1/trades`
- `service` string, required: Trade service slug — get slugs from `GET /v1/trades/{slug}`
- `quantity` number: Quantity in the service's unit (hours, jobs, sqm — returned in results)
- `postcode` string, nullable: Postcode filter, e.g. 2000 (Sydney), 3000 (Melbourne), 90210 (LA)
- `suburb` string, nullable: Suburb or city name, e.g. Surry Hills, Brooklyn
- `state` string, nullable: State/region code: NSW, VIC, QLD, WA, SA (AU) — or CA, NY, TX (US)
- `region` string, nullable: Region name, e.g. Sydney Metro, Greater London
- `country` string: Country code: AU, US, UK, CA, NZ

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)