---
title: "Search for places"
method: GET
path: "/search"
tags: ["Search"]
---

# Search for places

`GET /search`

Query the database for entries/places according to the search criteria
and order the top matching results by their total rating in descending
order.

The default result contains up to 100 entries. Use the `limit` parameter
to customize the desired amount. The server may decide to deliver less
results than requested up to some internal upper limit (currently 2000).

If the review status list is empty or missing only visible places
(created, confirmed) are returned.

## Query parameters

- `bbox` string
- `org_tag` string
- `categories` string
- `text` string
- `ids` string — Comma-separated list of identifiers
- `tags` string — Comma-separated list of tags
- `status` string — Comma-separated list of multiple review status names
- `limit` integer

## Response `200`

Successful response

- SearchResponse
  - `visible` SearchEntry[] — The entries that are in the given bounding box (bbox, area of the map).
    - `id` string — Identifier of a resource
    - `status` 'created' | 'confirmed' | 'rejected' | 'archived' — * created = initial status of each revision * confirmed/rejected = after positive/negative review * archived = final status
    - `lat` number, double — Geographic latitude (in degrees)
    - `lng` number, double — Geographic longitude (in degrees)
    - `title` string
    - `description` string
    - `categories` string[]
    - `tags` Tag[]
    - `ratings` AvgRatings — All average ratings of an entry.
      - `total` number
      - `diversity` number
      - `fairness` number
      - `humanity` number
      - `renewable` number
      - `solidarity` number
      - `transparency` number
  - `invisible` SearchEntry[] — Up to 5 entries outside the bbox.
    - `id` string — Identifier of a resource
    - `status` 'created' | 'confirmed' | 'rejected' | 'archived' — * created = initial status of each revision * confirmed/rejected = after positive/negative review * archived = final status
    - `lat` number, double — Geographic latitude (in degrees)
    - `lng` number, double — Geographic longitude (in degrees)
    - `title` string
    - `description` string
    - `categories` string[]
    - `tags` Tag[]
    - `ratings` AvgRatings — All average ratings of an entry.
      - `total` number
      - `diversity` number
      - `fairness` number
      - `humanity` number
      - `renewable` number
      - `solidarity` number
      - `transparency` number

---

[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)