Get Availability

curl --request GET \
  --url 'https://api.novacal.io/v1/availability?start=2026-05-29&end=2026-05-30&event_type_id=123&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"
        }
      ]
    }
  }
}

GET

availability

curl --request GET \
  --url 'https://api.novacal.io/v1/availability?start=2026-05-29&end=2026-05-30&event_type_id=123&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/availability?start=2026-05-29&end=2026-05-30&event_type_id=123&timezone=UTC' \
  --header 'Authorization: Bearer <token>'

Pass 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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

start

string<date>

required

Start date for the requested range

Example:

"2026-05-29"

end

string<date>

required

End date for the requested range

Example:

"2026-05-30"

event_type_id

integer

required

Event type ID used to calculate availability

Example:

123

timezone

string

default:UTC

Optional IANA timezone used to convert returned availability ranges. Defaults to UTC.

Example:

"Europe/Belgrade"

Response

200 - application/json

Availability response

success

boolean

required

Indicates whether the request was successful

Example:

true

data

object

required

Show child attributes

API Reference

Event Types

Booking Forms

Teams

Users

Availability

Events

Webhooks

Contacts

Authorizations

Query Parameters

Response