---
title: "Get availability"
method: GET
path: "/v3/scheduling/availability"
tags: ["Availability"]
---

# Get availability

`GET /v3/scheduling/availability`

Gets available time slots within the given time range, using the rules defined in the specified
Configuration object. If the Configuration `type` is `group`, Nylas returns only valid group events
within the time range, including recurring events.

Nylas validates the provided session ID and uses it to retrieve the related
[Configuration object](/docs/reference/api/configurations/). If you created a public
Configuration, you don't need to include the `Authorization` request header with a session ID, but
you do need to pass the Configuration object ID as a query parameter.

## Response `200`

Return availability

- object
  - `request_id` string — The request ID.
  - `data` object — The response to a successful request to get availability for a participant.
    - `order` string[] — (Round-robin events only) The order of participants in line to attend the proposed meeting.
    - `time_slots` AvailabilityTimeSlot[], nullable — An array of the available time slots when you can create a meeting using the requested settings. This field may be `null` if no time slots are available. Treat `null` the same as an empty array.
      - `emails` string[], nullable — A list of participant email addresses for this time slot. This field may be `null`. Treat `null` the same as an empty array.
      - `start_time` integer — The start of a time slot, in seconds using the Unix timestamp format.
      - `end_time` integer — The end of a time slot, in seconds using the Unix timestamp format.
      - `event_id` string — (Group Events Only). The event ID of the group event
      - `master_id` string — (Group Events Only). The master ID of the recurring group event
      - `calendar_id` string — (Group Events Only). The calendar ID of the group event

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit
- `504` — Provider Failure

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)