List a pool's hosts and their limits
curl --request GET \
--url https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts \
--header 'Authorization: <authorization>'import requests
url = "https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts', 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.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts",
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: <authorization>"
],
]);
$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.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"hosts": [
{
"userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"hostLimit": {
"perDay": 4,
"perWeek": 20,
"perMonth": 60,
"perYear": 500
},
"effectiveLimit": {
"perDay": 4,
"perWeek": 20,
"perMonth": 60,
"perYear": 500
}
}
],
"nextCursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Booking Limit Pools
List a pool's hosts and their limits
Returns the rotating hosts of the pool’s event types in user id order, each with their own limit and the limit enforced for them. Requires permission to update the team’s event types, since a host’s limit can reveal their overall booking limit. If accessed using an OAuth access token, the TEAM_EVENT_TYPE_WRITE scope is required.
GET
/
v2
/
teams
/
{teamId}
/
booking-limit-pools
/
{poolId}
/
hosts
List a pool's hosts and their limits
curl --request GET \
--url https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts \
--header 'Authorization: <authorization>'import requests
url = "https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts', 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.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts",
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: <authorization>"
],
]);
$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.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.cal.com/v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"status": "success",
"data": {
"hosts": [
{
"userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"hostLimit": {
"perDay": 4,
"perWeek": 20,
"perMonth": 60,
"perYear": 500
},
"effectiveLimit": {
"perDay": 4,
"perWeek": 20,
"perMonth": 60,
"perYear": 500
}
}
],
"nextCursor": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Headers
value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token
Path Parameters
Pool UUID; short UUID form is accepted too.
Query Parameters
The nextCursor of the previous page.
Example:
"0bce7b70-d7f0-4e5f-bcce-2f41b6fd5116"
Required range:
1 <= x <= 100Was this page helpful?