---
title: "List parks that match a trip category"
method: GET
path: "/categories/{slug}/parks"
tags: ["Propertys"]
---

# List parks that match a trip category

`GET /categories/{slug}/parks`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/categories/{slug}/parks`
- Auth: none declared

Return parks that match the given trip category slug.

The payload mirrors ``GET /properties/{id}/similar``: a
``SuccessPayload`` whose ``data`` is a list of expanded GeoJSON
features (same shape the ``/properties/json?expanded=true`` and
PDP similar-parks endpoints use), so the frontend transforms
follow the existing ``transformPropertyToPark`` pipeline.

* 200 + empty list when the slug is valid but no park currently
  qualifies (e.g. the structured feature hasn't landed in the
  environment yet, or the similarity floor is too strict).
* 404 when the slug is not one of the defined trip categories.
* 500 on DB or OpenAI failures during the resolve step.

## Path parameters

- `slug` string, required

## Query parameters

- `limit` integer: Maximum number of parks to return (1-200). Defaults to 50.
- `country` 'AU' | 'NZ': ISO country code used to scope public property inventory.

## Headers

- `API-Version` '1'

## Response `200`

Successful Response

- SuccessPayload
  - `msg` string, required
  - `data` union
    - object
    - unknown[]
      - unknown
    - string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/totalparks/apis/total-parks-public-api.md) · [All operations](https://skmtc.dev/totalparks/apis/total-parks-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/totalparks/apis/total-parks-public-api/revisions/dcb4c822e2c6?raw)