---
title: "Read a place"
method: GET
path: "/v1/places/{id}"
tags: ["Places"]
---

# Read a place

`GET /v1/places/{id}`

## Request

- Base URL: `https://api.onegoodarea.com`
- URL: `https://api.onegoodarea.com/v1/places/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

A place by its id: type, name, country and nation, centroid, validity, every code it is known by (current first), its parents nearest first up to the country, and the places it was formed from or became.

## Path parameters

- `id` string, required

## Response `200`

Default Response

- object
  - `place` object, required
    - `place_id` string, required
    - `place_type` 'country' | 'nation' | 'region' | 'district' | 'group' | 'neighbourhood', required
    - `name` string, required
    - `country` string, required
    - `nation` string, required
    - `id_origin` object, required
      - `scheme` 'iso3166-1' | 'iso3166-2' | 'ctry' | 'rgn' | 'lad' | 'msoa21' | 'iz2022' | 'lsoa21' | 'dz2022' | 'lsoa11' | 'dz2011' | 'iz2011', required
      - `code` string, required
    - `centroid` object, required
      - `latitude` number, required
      - `longitude` number, required
    - `valid_from` string, required
    - `valid_to` string, required
  - `aliases` object[], required
    - `scheme` 'iso3166-1' | 'iso3166-2' | 'ctry' | 'rgn' | 'lad' | 'msoa21' | 'iz2022' | 'lsoa21' | 'dz2022' | 'lsoa11' | 'dz2011' | 'iz2011', required
    - `code` string, required
    - `valid_from` string, required
    - `valid_to` string, required
    - `current` boolean, required
  - `parents` object[], required
    - `place_id` string, required
    - `place_type` 'country' | 'nation' | 'region' | 'district' | 'group' | 'neighbourhood', required
    - `name` string, required
    - `country` string, required
    - `nation` string, required
  - `predecessors` object[], required
    - `place` object, required
      - `place_id` string, required
      - `place_type` 'country' | 'nation' | 'region' | 'district' | 'group' | 'neighbourhood', required
      - `name` string, required
      - `country` string, required
      - `nation` string, required
    - `change_kind` 'split' | 'merge' | 'irregular', required
    - `share` number, required
    - `effective_on` string, required
  - `successors` object[], required
    - `place` object, required
      - `place_id` string, required
      - `place_type` 'country' | 'nation' | 'region' | 'district' | 'group' | 'neighbourhood', required
      - `name` string, required
      - `country` string, required
      - `nation` string, required
    - `change_kind` 'split' | 'merge' | 'irregular', required
    - `share` number, required
    - `effective_on` string, required
  - `meta` object, required
    - `engine_version` string, required
    - `generated_at` string, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `429`: Default Response
- `500`: Default Response

---

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