---
title: "History of place revisions"
method: GET
path: "/places/{id}/history/{revision}"
tags: ["Entries/Places"]
---

# History of place revisions

`GET /places/{id}/history/{revision}`

## Request

- Base URL: `https://api.ofdb.io/v0`
- URL: `https://api.ofdb.io/v0/places/{id}/history/{revision}`
- Auth: none declared

Loads the history of all place revisions including status reviews.

Optionally the result can be restricted to a single revision. If no
particular revision is requested then all revisions are returned.

Results are sorted in descending chronological order of activity time stamps,
i.e. the most recent changes appear first.

Only users with the role scout or admin are entitled to invoke this function.
Organizations must provide their API token for authorization.

## Path parameters

- `id` string, required: Identifier of a resource
- `revision` integer, required: A revision number

## Response `200`

Successful response

- PlaceHistory
  - `place` PlaceRoot, required: Immutable properties of a place
    - `id` string, required: Identifier of a resource
    - `lic` string, required
  - `revisions` PlaceRevisionLog[]
    - union[]
      - union
        - PlaceRevision
          - `created` Activity, required
            - `at` integer, required: Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps
            - `by` string: An e-mail address.
          - `rev` integer, required: A revision number
          - `tit` string, required
          - `dsc` string, required
          - `loc` Location
            - `deg` number[], required: WGS 84 coordinates (latitude, longitude) in degrees
            - `adr` Address
              - …
          - `cnt` Contact
            - `name` string: The full name of a person.
            - `phone` string
            - `email` string: An e-mail address.
          - `hrs` string: The opening hours in OpenStreetMap format. Specification: https://wiki.openstreetmap.org/wiki/Key:opening_hours Reference implementations: https://github.com/opening-hours/ Generator tool: https://projets.pavie.info/yohours/ The service trims leading/trailing whitespaces and stores values as is. Values are currently not validated against the OSM format syntax!
          - `fnd` string, date: The date on which an organization, initiative, or company has been founded or established.
          - `lnk` PlaceLinks
            - `www` string
            - `img` string
            - `img_href` string
          - `tag` Tag[]
        - ReviewStatusLog[]
          - `rev` integer: A revision number
          - `act` ActivityLog
            - `at` integer, required: Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps
            - `by` string: An e-mail address.
            - `ctx` string: Implicitly recorded context of an activity
            - `comment` string: Free text that describes the motivation or trigger for an activity
          - `status` 'created' | 'confirmed' | 'rejected' | 'archived': * created = initial status of each revision * confirmed/rejected = after positive/negative review * archived = final status

## Other responses

- `401`: Access token is missing or invalid or the user has insufficient permission

## Changes

- **2020-12-21** `db28fc148796`: 3 breaking
  - for the `path` request parameter `revision`, the format changed from `i64` to `int64`
  - the `revisions/items/items/oneOf[#/components/schemas/PlaceRevision]/rev` response's property format changed from `i64` to `int64` for status `200`
  - the `revisions/items/items/oneOf[#/components/schemas/ReviewStatusLogArray]/items/rev` response's property format changed from `i64` to `int64` for status `200`
- **2020-08-15** `ff081f133dc6`: 1 breaking, 1 info
  - the `revisions/items/items/oneOf[#/components/schemas/PlaceRevision]/cnt/name` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/PersonFullName` to the `revisions/items/items/oneOf[#/components/schemas/PlaceRevision]/cnt/name` response property `allOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/changes/places/:id/history/:revision/get.md)

---

[API](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api.md) - [All operations](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/revisions/4c454390b099?raw)