---
title: "Get rental prices by postcode"
method: GET
path: "/v1/rental/postcode/{postcode}"
tags: ["Rental Prices"]
---

# Get rental prices by postcode

`GET /v1/rental/postcode/{postcode}`

## 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/rental/postcode/{postcode}`
- Auth: none declared. Required headers: `X-API-Key`

Rental history for all suburbs that map to a given postcode.

Example: GET /v1/rental/postcode/3121   → Richmond, Burnley (VIC)
Example: GET /v1/rental/postcode/3121?bedrooms=2&property_type=flat

## Path parameters

- `postcode` string, required

## Query parameters

- `bedrooms` integer, nullable
- `property_type` string, nullable: flat, house, or all
- `periods` integer: Number of recent quarters

## 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)