Headers

Some special headers that could make your quality of life easier.

Request Headers

Header

Description

Accept-Language

This conforms to the regular HTTP specification for language but if the supplier has translated their content it will return the content in the specified language if possible. Also all error messages will be translated. eg. Accept-Language: fr the server will then respond with Language: fr depending on if that language was available.

X-TestMode

This header will mark any booking you perform with live credentials as a test sale. This will mean it will not consume any availability, the barcodes will not work, and you will not be invoiced for it. e.g. X-TestMode: true to turn it off, set the value to false.

Content-Type

This must be application/json for all POST PATCH and DELETE requests.

Response Headers

Header

Description

X-Capabilities

A list of the capabilities that were initialised with this request.

e.g. X-Capabilities: ventrata/pricing, ventrata/content

X-IPCountry

This is the ISO 3166 alpha-2 country code we determined for the requesting IP address. This could be useful if your integration is client-side only. e.g. FR

X-IPCurrency

This is the ISO 4217 currency code we determined for the requesting IP's country. This could be useful if your integration is client-side only. e.g. EUR

X-TestMode

This will return true if the request is in test, or false if it wasn't.

X-Request-Id

This request ID is auto-generated and can be used to help debug issues.

e.g. ff714978-4fc6-49b9-84a7-3963d9e118a7

Content-Language

This is the language of the content being returned. See the Localization section for info how to set it.