In order to process a booking you need to send a POST request to the following endpoint:

POST  /trainings/:id/bookings?api_key=YOUR_PRIVATE_API_KEY

To be able to process the request we need some data. The required fields are:

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:

Responses

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:

1. 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.
2. 400 Bad Request

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;

3. 403 Forbidden

When you're not allowed to create bookings.

4. 404 Not Found

When the training has not been found.