Our Booking API allows you to send bookings directly from your system to Springest. We will process the booking and make it available in our system for the user and the provider. We will also send out confirmation emails and
Access to this feature is currently restricted to authorized API users only. If you feel you need access to this feature, please contact firstname.lastname@example.org.
In order to process a booking you need to send a POST request to the following endpoint:
To be able to process the request we need some data. The required fields are:
|gender||string||"male" or "female"|
We also have some fields that might be required or might be optional. This depends on for which Springest site the booking should be created. For example, certain corporate customers might need a particular field, while others might not (contact Springest support if you're unsure):
Lastly, these fields are always optional:
When you POST your data to our API we run some validations on our end and will only process the conversion when they pass. When they don't, we let you know. As such, there are a couple of possible responses:
- 201 Created When the conversion has been created successfully. It will return the id of the conversion as a response. You can save this id as a reference to how we saved the booking.
- 400 Bad Request
- 403 Forbidden
- 404 Not Found
This will trigger when validation fails. The response will be JSON or XML (based on the url you are POSTing to) that looks like this:
We will also validate if the actual conversion can be made, based on the contract we have with the provider. For example, when you want to create a booking for a course that does not have a booking deal with us, you will receive;
When you're not allowed to create bookings.
When the training has not been found.