Read open shoot slots over a date range.
Read-only availability endpoint. Resolves the calling agency's Google Calendar via the manager-chain OAuth rule (CLAUDE.md: 'Google Calendar OAuth - Manager Chain Resolution') and returns open shoot slots in the agency's IANA timezone. Empty list when the calendar has no availability in the window.
| Method | Path |
|---|---|
GET | /api/v1/scheduling/availability |
Primary host: https://valara.cloud (legacy alias: https://dash.jacoballenmedia.com).
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
from | query | yes | string | Start of the window (inclusive, ISO-8601 date). |
to | query | yes | string | End of the window (inclusive, ISO-8601 date). |
duration_minutes | query | no | integer | Slot duration in minutes. Must be a multiple of 30, between 30 and 480. |
Request body
(no request body)
Response
null
Responses
| Status | Description |
|---|---|
200 | Successful Response |
422 | Validation Error (see error codes) |
Examples
curl
curl -X GET "https://valara.cloud/api/v1/scheduling/availability" \
-H "Authorization: Bearer $VALARA_API_KEY" \
-H "Content-Type: application/json"
Python
import os
import uuid
import httpx
res = httpx.request(
"GET",
"https://valara.cloud/api/v1/scheduling/availability",
headers={
"Authorization": f"Bearer {os.environ['VALARA_API_KEY']}",
"Content-Type": "application/json",
},
)
res.raise_for_status()
print(res.json())