List all bookings

List Bookings

This endpoint is essential for viewing and managing all bookings within a specified range or according to various filters, making it easier to oversee scheduling operations, track booking status, and generate reports.

Authentication

This endpoint needs app token for authentication.

Method	GET
Endpoint	v1/bookings
Headers	Accept: application/json
	Authorization: Bearer <base64_encoded_token>
Token Type	App

Query Parameters

This endpoint supports query parameters:

Field	Value	Description
include	meta,attributes,app,resources, customers	shows related meta, attributes, resources, customers
search	start_at,end_at	search bookings with start or end or both

Example Request:

Following code shows how to send request to retrieve bookings in Slotify api.

PHP
BASH

$endpoint = 'https://api.slotify.ca/v1/bookings';
$owner_token = base64_encode('app_token'); 

$curl = curl_init();

curl_setopt_array($curl, array(
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => '',
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 0,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => array(
        'Authorization: Bearer ' . $owner_token,
        'Accept: application/json',
        'Content-Type: application/json'
    ),
));

$response = curl_exec($curl);

if(curl_errno($curl)) {
    echo 'Error: ' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);

curl -X GET \
  https://api.slotify.ca/v1/bookings \
  -H 'Authorization: Bearer ' \
  -H 'Accept: application/json'

Example Response:

Following response will be provided by Slotify server when this endpoint is called:

200 Ok

{
    "data": [
        {
            "uuid": "803481f8-67bf-4046-b5e8-1b175ab211c8",
            "graph": "instant",
            "status": "confirmed",
            "end_at": "2024-09-05T14:00:00+00:00",
            "start_at": "2024-09-05T13:00:00+00:00",
            "created_at": "2024-09-03T19:25:15+00:00",
            "updated_at": "2024-09-03T19:25:15+00:00",
            "slot_price": 0,
            "is_paid": false,
            "slot_capacity": 5,
            "scheduler": {
                "slug": "instant",
                "mode": "round_robin",
                "uuid": "28f0b45d-d14f-438f-b59a-833a57a31147",
                "name": "Instant Scheduler",
                "color": "#84cc16",
                "event": {
                    "what": "Meeting with John Doe",
                    "location": {
                        "type": "google_meet"
                    },
                    "start_at": "2024-09-03",
                    "description": "Let's meet online and discuss details"
                },
                "graph": "instant",
                "duration": "1 hours",
                "timezone": "America/Toronto",
                "unit_price": 0,
                "min_notice": "1 days",
                "created_at": "2024-09-03T15:51:25+00:00",
                "updated_at": "2024-09-03T19:04:27+00:00",
                "buffer_time": "0 minutes",
                "time_format": null,
                "service_flow": "auto",
                "slot_capacity": 5,
                "booking_window": "4 weeks",
                "perday_capacity": 500,
                "min_cancellation": "1 days"
            }
        }
    ],
    "perPage": 25,
    "currentPage": 1,
    "total": 1,
    "totalPages": 1
}