---
title: "Search cities"
method: GET
path: "/api/v1/cities"
tags: ["cities"]
---

# Search cities

`GET /api/v1/cities`

## Request

- Base URL: `https://jointhestudentlife.com`
- URL: `https://jointhestudentlife.com/api/v1/cities`
- Auth: none required

Cities where The Student Life runs communities and events, with links to each city guide, festival page and Halloween page.

## Query parameters

- `q` string
- `country` string
- `limit` integer
- `cursor` string

## Response `200`

Matching cities

- CityList
  - `total` integer
  - `cities` CityCard[]
    - `slug` string
    - `name` string
    - `country` string
    - `country_code` string
    - `summary` string
    - `festival_name` string
    - `city_guide_url` string, uri
    - `festival_url` string, uri
    - `halloween_url` string, uri, nullable
  - `next_cursor` string, nullable: Pass as cursor to get the next page; null on the last page.

## Other responses

- `429`: Rate limited
- `default`: Error

---

[API](https://skmtc.dev/jointhestudentlife/apis/the-student-life-api.md) · [All operations](https://skmtc.dev/jointhestudentlife/apis/the-student-life-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jointhestudentlife/apis/the-student-life-api/revisions/d04925a4902b?raw)