# Booker Services

Endpoints from `booker-services` routes module.

## Create booking with reservation ID

 - [POST /v1/booker-services/appointments/confirm](https://timify-dev-api.redocly.app/apis/openapi/booker-services/postv1bookerservicesappointmentsconfirm.md): Confirm a reservation and convert it into a full appointment with customer data.

## Retrieve free bookable dates and times of a specific service or a group service

 - [GET /v1/booker-services/availabilities](https://timify-dev-api.redocly.app/apis/openapi/booker-services/getv1bookerservicesavailabilities.md): Bookable timeslots for a service or group service. There are two ways to request company information: 1. __company_id__ parameter 2. __external_company_id__ with __enterprise_id__ parameters Response parameters: - keys 'data.calendarBegin' and 'data.calendarEnd' - this is the allowed period for the availability algorithm. Can be adjusted in the web app under the section 'Booking setup' - key 'data.onDays' - array of dates with available time slots - key 'data.offDays' - array of dates that are fully booked - key 'data.slots.times' - array of times that are available for appointments To see the open slots for specific days, use the _days[]_ parameter. When the __service_id__ is present the service object is returned in the response. When the __course_id__ is present the course object is returned in the response.

## Check if an Appointment can be cancelled or reprogrammed.

 - [GET /v1/booker-services/booking-status](https://timify-dev-api.redocly.app/apis/openapi/booker-services/getv1bookerservicesbookingstatus.md): Check the status of the appointment, if the appointment can be cancelled or rescheduled.

## Retrieve public data for a company or multiple companies.

 - [GET /v1/booker-services/companies](https://timify-dev-api.redocly.app/apis/openapi/booker-services/getv1bookerservicescompanies.md): Example publicly availble data: - online bookable services - online bookable resources - customer fields __note:__ The use of the _company_external_id_ field is associated with the _enterprise_id_. This means that if you use the first one, it is mandatory to provide the second one.

## It returns the public information of an enterprise

 - [GET /v1/booker-services/enterprise](https://timify-dev-api.redocly.app/apis/openapi/booker-services/getv1bookerservicesenterprise.md): Data for an enterprise and branches that are online bookable. _At least one of the following fields are required:_ - __enterprise_id__ - __enterprise_slug__

## Reserve a booking in the system

 - [POST /v1/booker-services/reservations](https://timify-dev-api.redocly.app/apis/openapi/booker-services/postv1bookerservicesreservations.md): Reserve an appointment for a timeslot in the future. A reserved appointment needs to be confirmed

## Delete a reservation or an appointment

 - [DELETE /v1/booker-services/reservations/{reservationId}](https://timify-dev-api.redocly.app/apis/openapi/booker-services/deletev1bookerservicesreservationsbyreservationid.md): An appointment or reservation is only deleteable within a certain time period.