latestOpenAPI 3.1.1Altegio API Agreement2026-08-064243217.4 KB

bc9cbcc9c5f1

Appointments

List Appointments

Retrieve Appointments for a Location as JSON:API resource objects.

Pagination uses page and limit. The response includes the effective page, calculated offset, and limit in meta.pagination.

Date range values use YYYY-MM-DDTHH:MM:SS without a timezone. Provide filter[date_intersect_from] and filter[date_intersect_to] together; the end must be later than the start.

Related data can be requested by repeating the include parameter. Wire values remain literal API keys: client identifies Booking User data, staff identifies Team Member data, and goods identifies Products. Custom Field Value includes require the corresponding Business User permissions.

get/locations/{location_id}/appointments

Path parameters

location_idinteger required

Location ID

Query parameters

filter[client_id]integer

Filter by Booking User profile ID

filter[activity_id]integer

Filter by Event ID

filter[date_intersect_from]string
Example:2026-01-01T00:00:00

Start of the Appointment intersection range, without a timezone

filter[date_intersect_to]string
Example:2026-01-31T23:59:59

End of the Appointment intersection range, without a timezone

pageinteger

Page number

limitinteger

Maximum number of Appointments to return

includestring[]

Related resources to include; values are literal API keys

Headers

Acceptstring required

Required B2B v2 response media type. Use application/vnd.api.v2+json. A charset parameter is also accepted.

Authorizationstring required

Bearer {partner_token}, User {user_token}

Response

Appointments retrieved successfully