Overview
Our data is delivered in one of the standard formats shown below.
The standard formats allow automatic format conversion by appending a format parameter to the request: ?format=json
for example.
Note that errors are both reported within the response as well as in the HTTP header with the appropriate HTTP status codes. (200 is ok, 4xx is a client problem, 5xx a server problem.)
Default encoding is UTF-8.
Default timezones for all dates and times is UTC+0.
If you need help handling the output, don't hesitate to contact us for technical support.
HTML
Parameter:?format=html
HTML is the default output format. It shows all data with optional metadata in tabular form. Hover over values to see the metadata.
JSON(P)
Parameter:?format=json
Optional callback:?format=json&callback=...
The data and optional metadata is returned in the JavaScript Object Notation.
If an optional callback parameter is submitted, the response will be wrapped in a function call, according to the JSONP specifications. This allows for cross-domain requests from JavaScript.
XML
Parameter:?format=xml
All data and optional metadata is encoded in XML format.
CSV
Parameter:?format=csv
All data (withouth metadata) is outputted as CSV.
Values are separated by ;
, surrounded by "
and using \
as escape character.
YAML
Parameter:?format=yaml
All data and optional metadata is serialized in the YAML format.
See yaml.org for specifications and interpretation libraries.
Text
Parameter:?format=text
Some data can be returned as simple text, without any metadata.