---
title: "Get grant"
method: GET
path: "/v1/permissions/{id}"
tags: ["Permission"]
---

# Get grant

`GET /v1/permissions/{id}`

Get a grant by its ID.

## Response `200`

OK

- Grant — A scoped ReBAC grant that binds a principal to actions on a resource.
  - `id` string, required — Unique identifier of the grant.
  - `principal` string, required — ID of the principal that holds the grant.
  - `principal_type` 'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation', required
  - `scope` string, required — ID of the resource the grant applies to.
  - `scope_type` 'Assignment' | 'Attachment' | 'Comment' | 'Document' | 'Issue' | 'IssueRelation' | 'Label' | 'Namespace' | 'Notification' | 'Organization' | 'Permission' | 'Project' | 'ResourceType' | 'Role' | 'Team' | 'Todo' | 'User' | 'UserToken' | 'Folder' | 'Installation', required
  - `role_id` string, nullable, required — ID of the role whose actions are included in this grant.
  - `actions` Action[], required — Actions granted on the scope.
  - `created_at` string, date-time, required — Date when the grant was created.
  - `updated_at` string, date-time, nullable, required — Date when the grant was updated.

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `404` — The requested resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/opcotech/apis/elemo-api.md) · [All operations](https://skmtc.net/opcotech/apis/elemo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/opcotech/elemo-api/revisions/4640caa6d712/schema)