---
title: "Cities special request"
description: "City list and find requests support the params query parameter for related data."
canonical: https://docs.ordering.co/api-reference/guides/cities-special-request/
---

# Cities special request

City list and find requests support the `params` query parameter for related data. The supported `params` values are `country`, `administrator`, and `options`.

Use a comma-separated value when more than one relationship is needed:

```http
GET /countries/{country}/cities?params=country,administrator,options
```

When `params` is omitted, responses include all three relationships. When it is present, only the named relationships are expanded. `country_id` and `administrator_id` are scalar fields, not prerequisites that must be repeated inside `params`.

A compact synthetic response can have this shape:

```json
{
  "error": false,
  "result": [
    {
      "id": 101,
      "name": "Example City",
      "country_id": 12,
      "administrator_id": null,
      "country": {
        "id": 12,
        "name": "Example Country",
        "enabled": true
      },
      "administrator": null,
      "options": []
    }
  ]
}
```

The exact response wrapper, pagination metadata, and relation fields remain operation-specific. See [Get Cities](https://docs.ordering.co/api-reference/guides/get-cities/) and [Cities Model](https://docs.ordering.co/api-reference/guides/cities-model/) for related details.
