---
title: "Get a city guide"
method: GET
path: "/api/v1/cities/{slug}"
tags: ["cities"]
---

# Get a city guide

`GET /api/v1/cities/{slug}`

## Request

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

Costs, neighbourhoods, universities, housing tips, places and upcoming events for one city.

## Path parameters

- `slug` string, required

## Response `200`

City guide

- CityGuide
  - `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
  - `about` string
  - `monthly_costs` object[]
    - `label` string
    - `value` string
  - `universities` object[]
    - `name` string
    - `url` string
  - `upcoming_events` Event[]
    - `id` string
    - `type` 'halloween' | 'welcome_festival' | 'semester_kickoff' | 'orientation_week'
    - `name` string
    - `city` string
    - `city_slug` string, nullable
    - `start` string
    - `end` string, nullable
    - `timezone` string, nullable
    - `venue` object, nullable
      - `name` string
      - `address` string, nullable
    - `age_min` integer, nullable
    - `url` string, uri
    - `status` 'upcoming' | 'past'
    - `tickets` object
      - `status` 'on_sale' | 'opens_soon' | 'coming_soon' | 'see_page' | 'ended': opens_soon: published, but sales open at sales_open_at.
      - `options` TicketOption[]
        - `name` string
        - `price` number
        - `currency` string
      - `early_access` object, nullable
      - `buy_url` string, uri
      - `note` string
      - `sales_open_at` string, date-time, nullable: When ticket sales open, for status opens_soon.
    - `waitlist_open` boolean
    - `whatsapp_group` string, nullable
    - `entry_rule` string, nullable

## Other responses

- `404`: Error
- `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)