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.

MethodGET
Endpointv1/bookings
HeadersAccept: application/json 
Authorization: Bearer <base64_encoded_token> 
Token TypeApp

Query Parameters

This endpoint supports query parameters:

FieldValueDescription
includemeta,attributes,app,resources, customersshows related meta, attributes, resources, customers
searchstart_at,end_atsearch 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
}

Next Steps