---
title: "Send feedback"
method: POST
path: "/v1/feedback"
tags: ["Feedback"]
---

# Send feedback

`POST /v1/feedback`

## Request

- Base URL: `https://app.propcode.com.au/api`
- URL: `https://app.propcode.com.au/api/v1/feedback`
- Auth: HTTP bearer

Tells PropCode about a bug, a feature you or your user need, or anything else, such as an answer that looks wrong. A person at PropCode reads every one; the answer is always "Feedback logged.", with no reply through the API. Send one whenever something doesn't work as you expected. Include the requestId of the request it's about, from its error or its Request-Id header. Anything shaped like an API key is removed before it's stored. Test and live keys alike, up to 50 a day per organisation. Free.

## Request body

- object: Tell PropCode about a bug, a feature you need, or anything else. Free; a person at PropCode reads every one.
  - `kind` 'bug' | 'feature_request' | 'feedback', required: bug: something that doesn't work. feature_request: something you or your user need that PropCode doesn't do. feedback: anything else, such as an answer that looks wrong, or what worked.
  - `summary` string, required: One line, up to 120 characters.
  - `details` string: Optional. Up to 4,000 characters of plain text: the steps, what you expected and what happened.
  - `requestId` string, regex: Optional. The id of the request it's about, from an error's requestId or a Request-Id header.
  - `property` object: Optional. The property it's about.
    - `title` string, required: The property's title id, as GET /v1/properties gives it, with its jurisdiction. NSW: lot/plan (5008/DP752015), lot/section/plan (10/10/DP979849) or a strata plan (SP58841); for several lots, join their ids with +: 10/DP503890+11/DP503890. VIC: lot\plan (1001\PS340516). ACT: suburb, block and section (ACTON Block 11 Section 67). TAS: volume and folio (Volume 100007 Folio 1), or CID or PID.
    - `jurisdiction` string: The state: nsw (the default), vic, act or tas. Complying development answers are NSW only.
  - `reportId` string: Optional. The id of the report or Rapid Planning Report it's about.
  - `client` string: Optional. Your app's name and version, e.g. acme-planner 2.3.0.

## Response `201`

Logged.

- Feedback
  - `object` 'feedback', required
  - `message` 'Feedback logged.', required

## Other responses

- `400`: The request isn’t valid. Codes: `key_in_url`, `invalid_parameter`.
- `401`: No valid key. Codes: `missing_api_key`, `invalid_api_key`.
- `422`: Facts or jurisdiction not accepted. Codes: `unsupported_jurisdiction`.
- `429`: Over a limit: retry after Retry-After. Codes: `rate_limited`, `sandbox_daily_limit`, `feedback_limit_reached`.
- `500`: Our error. Codes: `internal_error`.

---

[API](https://skmtc.dev/propcode/apis/propcode-api.md) - [All operations](https://skmtc.dev/propcode/apis/propcode-api/llms.txt) - [OpenAPI document](https://skmtc.dev/propcode/apis/propcode-api/revisions/f393cce32349?raw)