curl --request GET \
--url 'https://api.novacal.io/v1/event-types/123/availability?start=2026-05-29&end=2026-05-30&timezone=UTC' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"availability": {
"2026-03-23": [
{
"start": "2026-03-23T09:00:00+00:00",
"end": "2026-03-23T17:00:00+00:00"
}
],
"2026-03-24": [
{
"start": "2026-03-24T10:00:00+00:00",
"end": "2026-03-24T15:00:00+00:00"
}
]
}
}
}Availability
Get Availability
Retrieve availability ranges for a Novacal event type across a selected date window so you can show bookable times in your app.
GET
/
v1
/
event-types
/
{id}
/
availability
curl --request GET \
--url 'https://api.novacal.io/v1/event-types/123/availability?start=2026-05-29&end=2026-05-30&timezone=UTC' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"data": {
"availability": {
"2026-03-23": [
{
"start": "2026-03-23T09:00:00+00:00",
"end": "2026-03-23T17:00:00+00:00"
}
],
"2026-03-24": [
{
"start": "2026-03-24T10:00:00+00:00",
"end": "2026-03-24T15:00:00+00:00"
}
]
}
}
}curl --request GET \
--url 'https://api.novacal.io/v1/event-types/123/availability?start=2026-05-29&end=2026-05-30&timezone=UTC' \
--header 'Authorization: Bearer <token>'
timezone as an optional IANA timezone, such as Europe/Belgrade, to receive availability ranges converted to that timezone. If omitted, the response uses UTC.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID of event type
Query Parameters
Start date for the requested range
Example:
"2026-05-29"
End date for the requested range
Example:
"2026-05-30"
Optional IANA timezone used to convert returned availability ranges. Defaults to UTC.
Example:
"Europe/Belgrade"