kulturkurier Developer Documentation

Endpoints

The API endpoints are at https://api.kulturkurier.de.

Response and Request Payload Format

The data is sent and received as UTF-8 encoded JSON. For XML responses just add add Content-Type: application/xml to the request header. Request payloads can only be sent as JSON.

Errors

  1. Sending invalid JSON will result in a 400 Bad Request response.
  2. Sending invalid fields will result in a 422 Unprocessable Entity or in a 409 Conflict response.
  3. Calling a endpoint or an entity which does not exist will result in a 404 Not Found response.

Pagination

Pagination can be performed using page and limit parameters. The default limit for all endpoints is 25. Page starts at 1.

Example request to receive the first 50 event show items:

https://api.kulturkurier.de/event-show/?page=1&limit=50

Data Formats

Data type Description
String Strings with a max length of 255 characters
Text Strings with a max length of 64 KB
Url Validated URLs with a max length of 255 characters
Integer 4 bytes integer
Date Single dates represented in the format YYYY-MM-DD
DateTime DateTimes represented as ISO 8601 string, i.e. in the format YYYY-MM-DDTHH:MM:SSZ
Time A single time represented as an integer from 0 to 2359, e.g 0 means 0 am, 1442 means 2.42 pm
Country Three-digit country code according to ISO 3166-1 alpha-3, e.g. DEU, ITA

Reference