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"
  }
]

Changes

Changed in 7 of the 50 revisions of this API.10312

Aug 8, 2021fdad7ffe40593See the full diff
- ▲
  the response property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/categories became optional for the status 200
  response-property-became-optional
- ▲
  the response property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/tags became optional for the status 200
  response-property-became-optional
- ▲
  the response property items/allOf[NewEntryWithLicense]/allOf[subschema #2]/license became optional for the status 200
  response-property-became-optional
Aug 8, 202136db91c229091See the full diff
- ▲
  the response property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/links became optional for the status 200
  response-property-became-optional
Aug 8, 2021faa932c519e73See the full diff
- ○
  the response property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/categories became required for the status 200
  response-property-became-required
- ○
  the response property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/links became required for the status 200
  response-property-became-required
- ○
  the response property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/tags became required for the status 200
  response-property-became-required
Aug 17, 20205cc6480bff0a1See the full diff
- ○
  added the new optional query request parameter org_tag
  new-optional-request-parameter
Aug 15, 2020ff081f133dc611See the full diff
- ▲
  the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/contact_name response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ○
  added PersonFullName to the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/contact_name response property allOf list for the response status 200
  response-property-all-of-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 13, 2020bca9ebb2d24a34See the full diff
- ▲
  the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/email response property's minLength was decreased from 3 to 0 for the response status 200
  response-property-min-length-decreased
- ▲
  the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/email response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ▲
  the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/telephone response's property type/format changed from string/ to / for status 200
  response-property-type-changed
- ○
  added the optional property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/contact_name to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/founded_on to the response with the 200 status
  response-optional-property-added
- ○
  added Email to the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/email response property allOf list for the response status 200
  response-property-all-of-added
- ○
  added Phone to the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/telephone response property allOf list for the response status 200
  response-property-all-of-added
Aug 13, 2020ddfd4e39c98d233See the full diff
- ▲
  the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/email response's property type/format changed from / to string/ for status 200
  response-property-type-changed
- ▲
  the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/telephone response's property type/format changed from / to string/ for status 200
  response-property-type-changed
- ●
  deleted the query request parameter org_tag
  request-parameter-removed
- ●
  removed the optional property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/contact_name from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property items/allOf[NewEntryWithLicense]/allOf[NewEntry]/founded_on from the response with the 200 status
  response-optional-property-removed
- ○
  removed Email from the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/email response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed Phone from the items/allOf[NewEntryWithLicense]/allOf[NewEntry]/telephone response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  the response property items/allOf[NewEntryWithLicense]/allOf[subschema #2]/license became required for the status 200
  response-property-became-required
This revision also has 17 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history