Get/List Availabilities

Retrieve a specific availability or list availabilities with filtering and pagination.

🔹 Endpoints

GET /api/v2/availabilities/{id}
GET /api/v2/availabilities

🔒 Authentication

Header	Required	Description
Authorization	Yes	Format: ONLIVESITE Credential:ONLIVEAccessKeyId, Signature=CalculatedSignature

📝 Path Parameter

Parameter	Type	Required	Description
id	string	Yes	Availability ID (UUID)

🔎 Query Parameters

Parameter	Type	Required	Description
page	number	No	Page number for pagination
limit	number	No	Items per page
calendarId	string (UUID)	No	Filter by calendar ID
serviceId	string (UUID)	No	Filter by service ID

Note: Advanced nested calendar filter and relation includes are supported by the backend, but typical usage focuses on calendarId/serviceId with pagination.

🧩 Examples

Get by ID

curl -X GET "https://openapi.onlive.site/api/v2/availabilities/1610c525-f19a-40d0-8cd1-03daba3d2d98" \
-H "Content-Type: application/json" \
-H "Authorization: ONLIVESITE Credential:ONLIVEAccessKeyId, Signature=CalculatedSignature"

List with Filters

curl -X GET "https://openapi.onlive.site/api/v2/availabilities?page=1&limit=10&calendarId=550e8400-e29b-41d4-a716-446655440000" \
-H "Content-Type: application/json" \
-H "Authorization: ONLIVESITE Credential:ONLIVEAccessKeyId, Signature=CalculatedSignature"

📤 Responses

• 200 OK (single): Returns an Availability object.
• 200 OK (list): Returns a paginated response { items, total, page, limit, pages } of Availability.

See Availability Properties for the object schema.