Sign in

v1

latestOpenAPI 3.0.3AGPLv32026-07-17448054.1 KB
Entries/Places

Get multiple entries

get/entries/{ids}

Path parameters

idsstring required

Comma-separated list of identifiers

Example:7cee99c287094a94acbdcf29ffff2e85,0884c4e86e404072b6874b99b7e32640,ed8a2aef20054102b20950b1b78eb581

Query parameters

org_tagstring

A single hash tag that is moderated by an organization.

Results will be filtered according to the current clearance status. Unclear revisions of entries will either be removed or replaced by older, already cleared revisions. Unclear revisions of entries are expected to only exist temporarily for a short time frame until a newer version has been cleared.

If the provided hash tag is not moderated by any organization the results will not be filtered by clearance status.

Only a single tag can be specified, because filtering according to clearance by multiple organizations could produce ambiguous and conflicting results.

Only when used in search requests: The hash tag will be included in the query as a mandatory search criteria like any other tag. Omitting this parameter and instead appending the moderated hash tag as a regular tag to the tags parameter will also return unfiltered search results, i.e. current revisions of entries independent of their clearance status.

Response

Successful response

titlestring required
descriptionstring required
latnumber double required

Geographic latitude (in degrees)

lngnumber double required

Geographic longitude (in degrees)

streetstring
zipstring
citystring
countrystring
statestring
contact_namestring

The full name of a person.

emailstring

An e-mail address.

telephonestring
homepagestring
opening_hoursstring

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!

founded_onstring date

The date on which an organization, initiative, or company has been founded or established.

categoriesstring[]
tagsTag[]
image_urlstring
image_link_urlstring
licensestring
idstring

Identifier of a resource

versioninteger
createdinteger
ratingsstring[]

Example response

[
  {
    "lat": 37.2,
    "lng": 120.7,
    "contact_name": "John Smith",
    "email": "john.smith@example.com",
    "telephone": "001 123456789",
    "homepage": "https://www.slowtec.de/",
    "opening_hours": "24/7",
    "founded_on": "1945-10-24",
    "tags": [
      "organic",
      "non-profit"
    ],
    "image_url": "https://www.slowtec.de/",
    "image_link_url": "https://www.slowtec.de/",
    "links": [
      {
        "url": "https://www.slowtec.de/"
      }
    ],
    "license": "ODbL-1.0",
    "id": "7cee99c287094a94acbdcf29ffff2e85"
  }
]