---
title: "Returns city details"
method: GET
path: "/core/latest/cities/{city-id}"
tags: ["Location"]
---

# Returns city details

`GET /core/latest/cities/{city-id}`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/cities/{city-id}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

Returns a City details with given id.

## Path parameters

- `city-id` string, required

## Response `200`

Found city

- City: A City that this partner locates.
  - `id` integer: The id of this City object
  - `zipCode` string: The postal code for this city
  - `basicPostcode` string
  - `name` string: Name of this City
  - `cityName27` string
  - `state` object: The State for this City
    - `id` string
    - `code` string: Code of this State
    - `description` string: Extended description of this State
  - `community` object: The Community for this City
    - `id` string
    - `bfsNumber` integer: BFS number of this Community
    - `communityName` string: Name of this Community
    - `conurbationNumber` string: Conurbation number of this Community
    - `state` object: State of this community
      - `id` string
      - `code` string: Code of this State
      - `description` string: Extended description of this State
  - `country` object: The Country of this City
    - `id` string
    - `countryName` string: Name of this Country
    - `iso2Code` string: 2 letter country code
    - `iso3Code` string: 3 letter country code
    - `phoneCode` string: Country calling code
    - `numericCode` string: ISO-numeric code

## Other responses

- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `404`: Resource not found<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)