---
title: "Fetch role"
method: GET
path: "/roles/{id}"
tags: ["Roles"]
---

# Fetch role

`GET /roles/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `id` string, required
  - `resource_type` 'Role', required — The resource type of the role
  - `applies_to` 'Organization' | 'Place' | 'Group', required
  - `name` string, required
  - `description` string, nullable, required
  - `custom` boolean, required
  - `permissions` object, required
    - `access_keys_read` boolean
    - `access_keys_write` boolean
    - `amenities_read` boolean
    - `amenities_write` boolean
    - `analytics_read` boolean
    - `apple_passes_read` boolean
    - `apple_passes_write` boolean
    - `bookings_read` boolean
    - `bookings_write` boolean
    - `camera_snapshot_sets_read` boolean
    - `camera_snapshots_read` boolean
    - `camera_snapshots_write` boolean
    - `cameras_read` boolean
    - `cameras_write` boolean
    - `capacities_read` boolean
    - `capacities_write` boolean
    - `card_assignments_read` boolean
    - `card_assignments_write` boolean
    - `cards_activate` boolean
    - `cards_read` boolean
    - `cards_write` boolean
    - `communication_policies_read` boolean
    - `communication_policies_write` boolean
    - `csv_card_import_read` boolean
    - `csv_card_import_write` boolean
    - `csv_user_import_read` boolean
    - `csv_user_import_write` boolean
    - `custom_roles_read` boolean
    - `custom_roles_write` boolean
    - `dashboards_read` boolean
    - `elevator_stops_permit` boolean
    - `elevator_stops_read` boolean
    - `elevator_stops_write` boolean
    - `elevators_read` boolean
    - `elevators_write` boolean
    - `event_retention_policies_read` boolean
    - `event_retention_policies_write` boolean
    - `events_read` boolean
    - `floors_read` boolean
    - `floors_write` boolean
    - `group_elevator_stops_read` boolean
    - `group_elevator_stops_write` boolean
    - `group_links_read` boolean
    - `group_links_write` boolean
    - `group_locks_read` boolean
    - `group_locks_write` boolean
    - `group_terminals_read` boolean
    - `group_terminals_write` boolean
    - `group_zones_read` boolean
    - `group_zones_write` boolean
    - `groups_read` boolean
    - `groups_write` boolean
    - `guests_read` boolean
    - `guests_write` boolean
    - `hardware_read` boolean
    - `hardware_write` boolean
    - `third_party_hf_uid_read_configurations_read` boolean
    - `third_party_hf_uid_read_configurations_write` boolean
    - `incident_occurrences_read` boolean
    - `incident_policies_read` boolean
    - `incident_policies_write` boolean
    - `incidents_read` boolean
    - `incidents_write` boolean
    - `integrations_read` boolean
    - `integrations_write` boolean
    - `intercom_assignment_read` boolean
    - `intercom_assignment_write` boolean
    - `intercom_completed_call_stream` boolean
    - `intercom_completed_call_stream_read` boolean
    - `invites_write` boolean
    - `kiosk_shortcuts_read` boolean
    - `kiosk_shortcuts_write` boolean
    - `locks_read` boolean
    - `locks_unlock` boolean
    - `locks_write` boolean
    - `logins_read` boolean
    - `logins_write` boolean
    - `managed_devices_read` boolean
    - `managed_devices_write` boolean
    - `marketplace_app_shares_read` boolean
    - `marketplace_app_shares_write` boolean
    - `marketplace_installations_read` boolean
    - `marketplace_installations_write` boolean
    - `marketplace_shortcuts_read` boolean
    - `marketplace_shortcuts_write` boolean
    - `mobile_cache_policies_read` boolean
    - `mobile_cache_policies_write` boolean
    - `place_dashboard_read` boolean
    - `places_read` boolean
    - `places_write` boolean
    - `reports_read` boolean
    - `reports_write` boolean
    - `role_assignments_read` boolean
    - `role_assignments_write` boolean
    - `scanned_card_read` boolean
    - `scanned_card_write` boolean
    - `scheduled_report_read` boolean
    - `scheduled_report_write` boolean
    - `schedules_read` boolean
    - `schedules_write` boolean
    - `shares_read` boolean
    - `shares_write` boolean
    - `subscriptions_read` boolean
    - `team_memberships_read` boolean
    - `team_memberships_write` boolean
    - `teams_read` boolean
    - `teams_write` boolean
    - `terminals_read` boolean
    - `terminals_trigger` boolean
    - `terminals_write` boolean
    - `users_read` boolean
    - `users_write` boolean
    - `visualization_page_reporters_read` boolean
    - `visualization_page_reporters_write` boolean
    - `visualization_page_shares_read` boolean
    - `visualization_page_shares_write` boolean
    - `zones_override` boolean
    - `zones_read` boolean
    - `zones_reset` boolean
    - `zones_write` boolean
  - `custom_role_id` integer, nullable, required — The custom_role ID of the role

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

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