---
title: "Get Use Permissibility"
method: GET
path: "/api/v1/planning/use-permissibility"
tags: ["Planning"]
---

# Get Use Permissibility

`GET /api/v1/planning/use-permissibility`

## Request

- Base URL: `https://api.casaintelligence.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.casaintelligence.com.au/api/v1/planning/use-permissibility`
- Auth: HTTP bearer

Look up whether a use is permitted in a zone and at what assessment level.

## Query parameters

- `use` string, required: Use name to look up (e.g. 'Dwelling house', 'Food and drink outlet')
- `zone_code` string, required: Zone code (e.g. 'LDR', 'NC', 'MU')
- `lga` string, required: LGA name (e.g. 'Brisbane', 'Gold Coast')
- `precinct` string, nullable: Precinct the land sits in, as stamped on the parcel (ci_properties.overlay_details->'zone_precinct'->>'code'). Required to get a single answer where a scheme answers per precinct — Moreton Bay's General residential precincts differ. Omit it and differing uses come back state=not_held with every precinct's answer named, which is the truth rather than a guess.

## Response `200`

Successful Response

- UsePermissibilityResponse
  - `exact_match` UsePermissibilityResult
    - `use_name` string, required
    - `zone_code` string, required
    - `zone_name` string, nullable
    - `lga` string, required
    - `permissibility` string, required
    - `state` string
    - `statement` string, nullable
    - `definition` string, nullable
    - `conditions` string, nullable
    - `applicable_codes` string[]
    - `provision_reference` string, nullable
    - `scheme_name` string, nullable
  - `similar_matches` UsePermissibilityResult[]
    - `use_name` string, required
    - `zone_code` string, required
    - `zone_name` string, nullable
    - `lga` string, required
    - `permissibility` string, required
    - `state` string
    - `statement` string, nullable
    - `definition` string, nullable
    - `conditions` string, nullable
    - `applicable_codes` string[]
    - `provision_reference` string, nullable
    - `scheme_name` string, nullable
  - `query` string, required
  - `zone_code` string, required
  - `lga` string, required
  - `state` string
  - `statement` string, nullable
  - `citation` object, nullable
  - `disclaimer` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/casaintelligence/apis/casa-intelligence-engine.md) · [All operations](https://skmtc.dev/casaintelligence/apis/casa-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/casaintelligence/apis/casa-intelligence-engine/revisions/71d711039de0?raw)
