Find Available Intervals

post

https://api.appointedd.com/v1/availability/intervals/search

Find available intervals of dates and times for one or more of your resources in your organisation.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

ranges

array of objects

required

One or more ranges of dates & times to query for available intervals.

ranges*

service_id

string

required

Unique identifier of the service in your organisation to use when calculating the available intervals.

resource_ids

array of strings

One or more unique identifiers of resources to find available intervals for. If not set this defaults to all of the resources assigned to the service you specified.

resource_ids

resource_group_ids

string

One or more unique identifiers of resource groups whose resources you want to find available intervals. Mutually exclusive with resource_ids.

buffers

object

Controls the amount of time before and/or after a booking that must not contain any other bookings, breaks, or external events. If you do not specify any buffers then they will either be loaded from a service if you have given one, or default to query with no buffers.

duration

int32

Number of continuous minutes of time from the start of an interval that must be free for an interval to be considered available. If you do not specify the parts property or this property, and you have specified a service property, the default duration or parts for that service will be used. If you specify the parts property in this request this property will be ignored.

parts

array of objects

parts

spaces

int32

Defaults to 1

Number of spaces that are required. This is used to exclude any group bookings that do not have enough spaces.

timezone

string

Defaults to Europe/London

Name of an IANA timezone to return the resulting dates & times in.

ignore_past_restriction

boolean

Defaults to false

If set to true availability will not be restricted by the current date and time. By default this is set to false and any date and time before the current date and time will be considered as unavailable.

ignore_notice_restriction

boolean

Defaults to false

If set to true availability will not be restricted by your organisation's or service's notice period settings. By default this is set to false and any date and time before the number of minutes/hours/days added onto the current date and time will be considered as unavailable.

ignore_bookings

array of strings

One or more unique identifiers of bookings in your organisation to ignore for the purposes of this availability query. This means that it will not block availability and if it is a group booking it will not be returned if it is available.

ignore_bookings

ignore_service_assignment

boolean

Defaults to false

If set to true, the request will not fail if the resource on this booking is not assigned to the service on this booking.

ignore_service_schedule

boolean

Defaults to false

If set to true availability will not be restricted by the service's schedule. By default this is set to false and any date and time outside of the service's schedule will be considered as unavailable.

ignore_group_setting

boolean

Defaults to false

If set to true the availability will return bookings that have enough space as group bookings, regardless if they have online group bookings turned on.

ignore_block_restriction

boolean

Defaults to false

If set to true availability will ignore the block after setting on your account.

Response

200200