Get Available Time Slots by Shared Link

GET

availability-by-shared-link

{sharedLink}

Get available time slots by shared link

curl --request GET \
  --url https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "ownerSlug": "shared",
  "eventTypeSlug": "30min-discovery-call",
  "schedulingUrl": "https://zeeg.me/shared/30min-discovery-call",
  "duration": 30,
  "firstAvailableDate": "2026-04-01",
  "lastAvailableDate": "2026-04-14",
  "timeZone": "Europe/Paris",
  "timeZoneOffset": "+02:00",
  "isNotAvailable": false,
  "availability": [
    {
      "date": "2026-04-01",
      "slots": [
        "09:00",
        "09:30",
        "10:00",
        "10:30",
        "14:00",
        "14:30",
        "15:00"
      ]
    },
    {
      "date": "2026-04-02",
      "slots": [
        "09:00",
        "09:30",
        "10:00",
        "11:00",
        "14:00",
        "15:00"
      ]
    },
    {
      "date": "2026-04-03",
      "slots": []
    },
    {
      "date": "2026-04-04",
      "slots": []
    },
    {
      "date": "2026-04-05",
      "slots": [
        "09:00",
        "10:00",
        "14:00",
        "14:30"
      ]
    }
  ],
  "currentTime": "2026-03-20T12:00:00+00:00"
}

Authorizations

Authorization

string

header

required

Path Parameters

sharedLink

string

required

The shared scheduling link identifier (e.g. the token from a shared or collective scheduling link URL).

Query Parameters

startDate

string<date>

required

Start date in YYYY-MM-DD format.

Example:

"2026-04-01"

endDate

string<date>

required

End date in YYYY-MM-DD format.

Example:

"2026-04-14"

timeZone

string

default:UTC

required

IANA time zone identifier.

Example:

"Europe/Berlin"

duration

number

Meeting duration in minutes. Defaults to the event type's configured duration.

withHostsCount

boolean

Set to 1 to include available host count for each time slot.

hostEmail

string<email>

Email of the host to filter available slots for (useful for Round Robin events).

hostSlug

string

Slug of the host to filter available slots for (useful for Round Robin events).

check_first_available

boolean

When set to 1, the response will include the first available date.

seats

integer

Number of seats to book (for group event types).

Required range: x >= 1

locationKey

string

Optional location-aware availability. The per-location stable key from the location resource's key field (e.g. loc_42), or room_<resourceId> for a room. The bare location enum string (e.g. ZOOM) is still accepted for backward compatibility. For a Round Robin event type it prunes availability to hosts that can fulfill that location (Meet/Teams/Skype/Zoom/Webex/Demodesk integration), and for a room location it intersects only that room's calendar. Omit for unfiltered availability (the default, pre-location-aware behavior).

Example:

"loc_42"

Response

ownerSlug

string

eventTypeSlug

string

schedulingUrl

string<uri>

duration

integer

firstAvailableDate

string<date>

lastAvailableDate

string<date>

timeZone

string

timeZoneOffset

string

isNotAvailable

boolean

availability

object[]

Hide child attributes

availability.date

string<date>

availability.slots

(string | object)[]

Array of time strings or objects with time and availableHosts when withHostsCount=1.

currentTime

string<date-time>

Last modified on April 29, 2026

Get available time slots by shared link

curl --request GET \
  --url https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.zeeg.me/v2/availability-by-shared-link/{sharedLink}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "ownerSlug": "shared",
  "eventTypeSlug": "30min-discovery-call",
  "schedulingUrl": "https://zeeg.me/shared/30min-discovery-call",
  "duration": 30,
  "firstAvailableDate": "2026-04-01",
  "lastAvailableDate": "2026-04-14",
  "timeZone": "Europe/Paris",
  "timeZoneOffset": "+02:00",
  "isNotAvailable": false,
  "availability": [
    {
      "date": "2026-04-01",
      "slots": [
        "09:00",
        "09:30",
        "10:00",
        "10:30",
        "14:00",
        "14:30",
        "15:00"
      ]
    },
    {
      "date": "2026-04-02",
      "slots": [
        "09:00",
        "09:30",
        "10:00",
        "11:00",
        "14:00",
        "15:00"
      ]
    },
    {
      "date": "2026-04-03",
      "slots": []
    },
    {
      "date": "2026-04-04",
      "slots": []
    },
    {
      "date": "2026-04-05",
      "slots": [
        "09:00",
        "10:00",
        "14:00",
        "14:30"
      ]
    }
  ],
  "currentTime": "2026-03-20T12:00:00+00:00"
}