---
title: "List clearance of places"
method: GET
path: "/places/clearance"
tags: ["Entries/Places"]
---

# List clearance of places

`GET /places/clearance`

Returns a list of places with pending clearance on behalf
of the requesting organization in chronological order.

Requests must include the API token of the organization.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful response

- PendingClearanceForPlace[]
  - `place_id` string, required — Identifier of a resource
  - `created_at` integer, required — Precise Unix time (number of milliseconds since 00:00::00.000 1. January, 1970, UTC) for system-generated time stamps
  - `last_cleared_revision` integer — A revision number

## Other responses

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

## Changes

- **2020-12-21** `db28fc148796` — 1 breaking
  - the `items/last_cleared_revision` response's property type/format changed from `integer`/`i64` to `integer`/`int64` for status `200`
- **2020-08-13** `b2a47c048e83` — 1 breaking, 2 info
  - the `items/created_at` response's property type/format changed from `integer`/`int64` to ``/`` for status `200`
  - added `#/components/schemas/UnixTimeMillis` to the `items/created_at` response property `allOf` list for the response status `200`
  - the response required property `items/created_at` became not read-only for the status `200`
- **2020-08-13** `ddfd4e39c98d` — 2 breaking, 2 info
  - the `items/created_at` response's property type/format changed from ``/`` to `integer`/`int64` for status `200`
  - the `items/last_cleared_revision` response's property type/format changed from `integer`/`int64` to `integer`/`i64` for status `200`
  - removed `#/components/schemas/UnixTimeMillis` from the `items/created_at` response property `allOf` list for the response status `200`
  - the response required property `items/created_at` became read-only for the status `200`

[Change history](https://skmtc.dev/kartevonmorgen/apis/openfairdb-api/changes/places/clearance/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-service-production.skmtc.workers.dev/v1/apis/kartevonmorgen/openfairdb-api/revisions/4c454390b099/schema)