---
title: "List schedule access"
method: GET
path: "/scheduling/v1/schedules/{schedule_id}/access"
tags: ["Schedules"]
---

# List schedule access

`GET /scheduling/v1/schedules/{schedule_id}/access`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/scheduling/v1/schedules/{schedule_id}/access`
- Auth: HTTP bearer

Returns a list of authorization rules for the schedule.

## Path parameters

- `schedule_id` string, required

## Response `200`

A successful response.

- S12SchedulingV1ListScheduleAccessResponse: ListScheduleAccessResponse is the response for ListScheduleAccess.
  - `grants` S12SchedulingV1AccessGrant[]: The discrete access grants on the schedule.
    - `grantee` S12SchedulingV1Grantee, required: Grantee is the typed identifier of an entity holding an access grant. Exactly one variant must be set.
      - `user` S12SchedulingV1User: User represents a user identified by its id. The name field is populated by the server on responses and ignored on requests.
        - `id` string, required
        - `name` string
      - `group` S12SchedulingV1Group: Group represents a group identified by its id. The name field is populated by the server on responses and ignored on requests.
        - `id` string, required
        - `name` string
    - `level` 'ACCESS_LEVEL_UNSPECIFIED' | 'ACCESS_LEVEL_VIEWER' | 'ACCESS_LEVEL_EDITOR' | 'ACCESS_LEVEL_OWNER', required: AccessLevel is the discrete access a grantee holds on a schedule.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
