---
title: "Guide for AI agents"
description: "How AI assistants can use Surgery Waits: what it does and does not do, its addresses, its data files and a prompt to paste."
url: "https://surgerywaits.au/agents/"
---

# Guide for AI agents

Surgery Waits publishes how long people waited for planned surgery in Australian public hospitals, by surgery, hospital, state and urgency category, from Australian Institute of Health and Welfare (AIHW) MyHospitals data.

Reference period 2024–25 (1 July 2024 to 30 June 2025) · released 28 May 2026.

## What the site does

- Covers 293 public hospitals and 151 surgery types, for the reference period 2024–25, released 28 May 2026.
- Gives each hospital's median wait in days, the share of patients who waited more than 365 days, and the number of surgeries done. Every figure states its reference period and release date.
- Orders hospitals by the published median wait only, shortest first, and says so on the page. A hospital with a suppressed or out-of-date figure is listed but never ranked.
- Shows Queensland Health quarterly figures (latest July to September 2025) on Queensland hospital pages, beside the national figures and never blended into them.
- Publishes the same figures as JSON under https://surgerywaits.au/data-api/, described by an OpenAPI document at https://surgerywaits.au/data-api/openapi.json.
- Runs the compare tool entirely in the browser: a suburb or postcode typed into it is never sent anywhere.

## What it does not do

- It gives no medical advice. It does not recommend a hospital, doctor or treatment, and it does not rate hospitals. A person's general practitioner (GP) or specialist helps them decide. In an emergency, call 000.
- Public hospitals only. Private hospitals do not report to this collection, so their waiting times cannot be compared here.
- New South Wales figures, like every state's, are the annual AIHW figures. Only Queensland has quarterly figures here.
- It does not book surgery, make referrals or hold a place on a waiting list, and it cannot tell anyone where they are on a list. The treating hospital or specialist can.
- A figure the source suppressed reads "not published". It is not zero, not a blank and not a rank; repeat it as "not published".
- The figures are waits that have already happened. They do not predict how long one person will wait.

## How the addresses work

Every page URL ends in a slash; chart images end in.svg instead. {surgery} is the slug on https://surgerywaits.au/surgery/, {hospital} the slug on https://surgerywaits.au/hospitals/, {state} one of nsw, vic, qld, wa, sa, tas, act, nt, {n} an urgency category, 1, 2 or 3, and {area} a place listed on a surgery's state pages. Not every surgery and hospital pair exists: a hospital has a page only for the surgeries it reported this period, and a place has a page only for the surgeries at least two of its hospitals published a median for.

Address patterns, with an example of each.

| Pattern | What is there | Example |
| --- | --- | --- |
| `/` | Home, with the compare tool: search by suburb or postcode in the browser. | [https://surgerywaits.au/](https://surgerywaits.au/) |
| `/surgery/` | Every surgery type the source reports. | [https://surgerywaits.au/surgery/](https://surgerywaits.au/surgery/) |
| `/surgery/{surgery}/` | One surgery: the national and state medians, and every public hospital that reports it. | [https://surgerywaits.au/surgery/skin-lesion-removal/](https://surgerywaits.au/surgery/skin-lesion-removal/) |
| `/surgery/{surgery}/{state}/` | One surgery in one state, with each hospital's median wait. | [https://surgerywaits.au/surgery/skin-lesion-removal/nsw/](https://surgerywaits.au/surgery/skin-lesion-removal/nsw/) |
| `/surgery/{surgery}/near/{area}/` | One surgery near one place: the public hospitals in and near it, ranked by published median wait. | [https://surgerywaits.au/surgery/cataract-surgery/near/adelaide-cbd/](https://surgerywaits.au/surgery/cataract-surgery/near/adelaide-cbd/) |
| `/hospitals/` | Every public hospital, by state. | [https://surgerywaits.au/hospitals/](https://surgerywaits.au/hospitals/) |
| `/hospital/{hospital}/` | One public hospital: every surgery it reports, with trends. | [https://surgerywaits.au/hospital/albany-hospital/](https://surgerywaits.au/hospital/albany-hospital/) |
| `/hospital/{hospital}/{surgery}/` | One surgery at one hospital: the median wait, the share who waited over a year, and nearby hospitals. | [https://surgerywaits.au/hospital/albany-hospital/skin-lesion-removal/](https://surgerywaits.au/hospital/albany-hospital/skin-lesion-removal/) |
| `/state/{state}/` | One state or territory: every surgery's median wait there. | [https://surgerywaits.au/state/nsw/](https://surgerywaits.au/state/nsw/) |
| `/urgency/` | The three urgency categories and what they mean. | [https://surgerywaits.au/urgency/](https://surgerywaits.au/urgency/) |
| `/urgency/category-{n}/` | One urgency category (1, 2 or 3), by hospital. | [https://surgerywaits.au/urgency/category-2/](https://surgerywaits.au/urgency/category-2/) |
| `/urgency/category-{n}/{state}/` | One urgency category in one state. | [https://surgerywaits.au/urgency/category-2/nsw/](https://surgerywaits.au/urgency/category-2/nsw/) |
| `/health-service/{service}/` | The public hospitals one local health service runs. | [https://surgerywaits.au/health-service/albury-wodonga-health/](https://surgerywaits.au/health-service/albury-wodonga-health/) |
| `/longest-waits/` | The longest published waits. | [https://surgerywaits.au/longest-waits/](https://surgerywaits.au/longest-waits/) |
| `/longest-waits/border/` | Shorter waits across a state border. | [https://surgerywaits.au/longest-waits/border/](https://surgerywaits.au/longest-waits/border/) |
| `/longest-waits/changes/` | The largest changes since the previous year. | [https://surgerywaits.au/longest-waits/changes/](https://surgerywaits.au/longest-waits/changes/) |
| `/guides/` | Plain-language guides: urgency, referrals, how waiting lists work. | [https://surgerywaits.au/guides/](https://surgerywaits.au/guides/) |
| `/methodology/` | How every figure is sourced, shown and ordered. | [https://surgerywaits.au/methodology/](https://surgerywaits.au/methodology/) |
| `/charts/{surgery}.svg` | The state comparison for one surgery as a standalone SVG chart. | [https://surgerywaits.au/charts/skin-lesion-removal.svg](https://surgerywaits.au/charts/skin-lesion-removal.svg) |

## Files for machines

- [Guide for AI agents](https://surgerywaits.au/agents/): This guide: what the site does and does not do, its addresses, and a prompt to paste.
- [llms.txt](https://surgerywaits.au/llms.txt): The same guide as plain text, in one fetch.
- [Data API (OpenAPI 3.1)](https://surgerywaits.au/data-api/openapi.json): Describes every JSON file under /data-api/, including how suppressed figures and attribution are given.
- [Procedures index (JSON)](https://surgerywaits.au/data-api/procedures/index.json): Every surgery type, with its source id and page slug.
- [MCP server](https://surgerywaits.au/mcp/server-card): The server card for the read-only MCP server at https://surgerywaits.au/mcp: tools to get a wait, compare hospitals near a place, find a surgery and explain an urgency category. No sign-in. Its usage log holds the tools, argument names and client software of each request, never what was asked or the address it came from (see https://surgerywaits.au/privacy/).
- [Markdown copies of pages](https://surgerywaits.au/index.md): Most pages as Markdown, at the page's address with.md in place of the closing slash: /surgery/hip-replacement/ is /surgery/hip-replacement.md, and this is the home page's. A hospital's page for a single surgery has no copy.
- [Sitemap](https://surgerywaits.au/sitemap.xml): Every indexable page.
- [robots.txt](https://surgerywaits.au/robots.txt): Crawl rules: search and AI answers are allowed; AI training is not.

## Sources and licences

The figures keep their source licences. Credit the publisher, not this site. The [attribution page](https://surgerywaits.au/attribution/) has the full wording.

- [ABS Australian Statistical Geography Standard 2021, Suburbs and Localities](https://geo.abs.gov.au/arcgis/rest/services/ASGS2021/SAL/MapServer/0), Australian Bureau of Statistics. [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). 2021, released 20 July 2021. Attribution: "Based on ABS Australian Statistical Geography Standard 2021, Suburbs and Localities, © Australian Bureau of Statistics, used under Creative Commons Attribution 4.0 International (CC BY 4.0)."
- [AIHW MyHospitals API](https://myhospitalsapi.aihw.gov.au/api/v1/), Australian Institute of Health and Welfare. [Creative Commons Attribution 3.0 Australia (CC BY 3.0 AU)](https://creativecommons.org/licenses/by/3.0/au/). 2024–25, released 28 May 2026. Attribution: "Based on AIHW MyHospitals API, © Australian Institute of Health and Welfare, used under Creative Commons Attribution 3.0 Australia (CC BY 3.0 AU)."
- [Queensland Health elective surgery quarterly data](https://www.data.qld.gov.au/dataset/elective-surgery), Queensland Health. [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/). July to September 2025, released 28 October 2025. Attribution: "Based on Queensland Health elective surgery quarterly data, © Queensland Health, used under Creative Commons Attribution 4.0 International (CC BY 4.0)."

## A prompt to give an assistant

Copy this into a chat assistant before asking it about surgery waits.

```
Use https://surgerywaits.au/ to answer questions about public hospital waiting times for planned surgery in Australia.
Read https://surgerywaits.au/llms.txt first. It explains the site's addresses and limits.
Give the median wait in days with its reference period and release date, and link the page you used.
Credit the source: Australian Institute of Health and Welfare, Creative Commons Attribution 3.0 Australia (CC BY 3.0 AU).
If a figure reads "not published", say that. Never treat it as zero and never rank it.
Private hospitals are not covered. New South Wales figures are annual.
This is not medical advice: suggest the person talk to their GP or specialist.
```

## Before you use these figures

Surgery Waits is not medical advice. It republishes official statistics about waiting times that have already happened, and it does not recommend any hospital, doctor or treatment. Your general practitioner (GP) and your treating specialist are the right people to help you decide what is appropriate for you.

**In an emergency call 000.**

Waiting-time figures: Australian Institute of Health and Welfare MyHospitals, licensed under [CC BY 3.0 AU](https://creativecommons.org/licenses/by/3.0/au/). Quarterly state figures: Queensland Health. Suburb and locality data: Australian Bureau of Statistics. Both licensed under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Surgery Waits is not connected with any of these organisations.

Surgery Waits is published by [National Digital](https://nationaldigital.com.au/).

* * *

This is the Markdown copy of https://surgerywaits.au/agents/.