API docs by Redocly

Enjoyracing.sk - Reservations API (1.3.2)

Download OpenAPI specification:Download

Webnotion s.r.o.: developers@webnotion.sk URL: https://www.webnotion.sk

OpenApi doc for Enjoyracing.sk Reservations API.

Changelog

version date change
v1.3.2 2025-12-18 Update options in car_ride_lengths.csv for 2026 season
v1.3.1 2025-07-22 Update car_ride_lengths.csv codelist (car_id = 3)
v1.3.0 2025-07-11 Modify data type of time_slot in /create-reservation endpoint
v1.2.1 2025-07-08 Modify cars.csv - add ID=3 - Race day
v1.2.0 2025-06-11 Modify available slots endpoint input parameters
v1.1.0 2025-06-09 Add static codelist car_ride_lengths.csv
v1.0.0 2025-05-20 Initial version

Static codelists

name last update
cars.csv 2025-07-08
locations.csv 2025-05-20
additional_services.csv 2025-05-20
car_ride_lengths.csv 2025-12-18

Endpoints

Available slots

Returns available combinations for reservation for a specified date range (from, to), location, car and ride length (variants/rounds).

Authorizations:
AuthToken
query Parameters
from
required
string <date>

Start date for slot availability lookup

to
required
string <date>

End date for slot availability lookup

location_id
required
integer

Location ID (from static codelist locations.csv)

car_id
required
integer

Car ID (from static codelist cars.csv)

ride_length_id
required
integer

Ride length ID (from static codelist car_ride_lengths.csv)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create reservation

Submits a reservation for specific combination of date + location + car + time slot and with additional reservation information.

Authorizations:
AuthToken
Request Body schema: application/json
required
object (ReservationCustomerData)
date
required
string <date>

Date of selected term

time_slot
required
Array of strings <time> (TimeSlot) [ 1 .. 2 ] items unique

Selected time slot (start time). If car_id === 3, then send exactly 2 time slots, otherwise send 1 time slot.

location_id
required
integer

ID of location from static codelist locations.csv

car_id
required
integer

ID of car from static codelist cars.csv

ride_length_id
required
integer

ID from car_ride_lengths.csv codelist (car_id have to match)

voucher_code
required
string [ 5 .. 50 ] characters

Voucher code, not unique string (same can be sent multiple times). Format is completelly custom.

additional_services
required
Array of integers

Array of IDs of additional services from codelist additional_services.csv. Send here only IDs of services picked by customer. If no additional service picked by customer, then return empty array.

note
required
string or null

Optional (required, but nullable) note for order (from client or partner's internal notes)

Responses

Request samples

Content type
application/json
Example
{
  • "customer": {
    },
  • "date": "2025-05-20",
  • "time_slot": [
    ],
  • "location_id": 3,
  • "car_id": 1,
  • "ride_length_id": 10,
  • "voucher_code": "XYZ-1234567",
  • "additional_services": [
    ],
  • "note": "Lorem ipsum dolor..."
}

Response samples

Content type
application/json
Example
{
  • "status": "OK",
  • "reservation_id": 12345
}

AvailableSlot

date
required
string <date>

Date of term

location_id
required
integer

ID of location from locations codelist

car_id
required
integer

ID of car from codelist

free_slots
required
Array of strings <time> (TimeSlot)

List of available slots.

{
  • "date": "2025-05-20",
  • "location_id": 3,
  • "car_id": 1,
  • "free_slots": [
    ]
}

TimeSlot

string <time> (TimeSlot)

String time representation of time slot available for reservation.

"09:40:00"

ReservationData

required
object (ReservationCustomerData)
date
required
string <date>

Date of selected term

time_slot
required
Array of strings <time> (TimeSlot) [ 1 .. 2 ] items unique

Selected time slot (start time). If car_id === 3, then send exactly 2 time slots, otherwise send 1 time slot.

location_id
required
integer

ID of location from static codelist locations.csv

car_id
required
integer

ID of car from static codelist cars.csv

ride_length_id
required
integer

ID from car_ride_lengths.csv codelist (car_id have to match)

voucher_code
required
string [ 5 .. 50 ] characters

Voucher code, not unique string (same can be sent multiple times). Format is completelly custom.

additional_services
required
Array of integers

Array of IDs of additional services from codelist additional_services.csv. Send here only IDs of services picked by customer. If no additional service picked by customer, then return empty array.

note
required
string or null

Optional (required, but nullable) note for order (from client or partner's internal notes)

{
  • "customer": {
    },
  • "date": "2025-05-20",
  • "time_slot": [
    ],
  • "location_id": 3,
  • "car_id": 1,
  • "ride_length_id": 10,
  • "voucher_code": "XYZ-1234567",
  • "additional_services": [
    ],
  • "note": "Lorem ipsum dolor..."
}

ReservationCustomerData

first_name
required
string

First name of customer.

last_name
required
string

Last name of customer.

email
required
string <email>

Contact e-mail of customer, for email communication about reservation.

phone
required
string

Contact phone number of customer for operational communication in specific cases. (defined format is preferred but not forced)

{
  • "first_name": "John",
  • "last_name": "Doe",
  • "email": "john.doe@domain.tld",
  • "phone": "+421000111222"
}