---
title: "Get space role by ID"
method: GET
path: "/space-roles/{id}"
tags: ["Space Roles"]
---

# Get space role by ID

`GET /space-roles/{id}`

Retrieves the space role by ID.

Available on tenants with [Role-Based Access Control](https://support.atlassian.com/confluence-cloud/docs/manage-user-roles/). 

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
Permission to access the Confluence site.

## Path parameters

- `id` integer, required

## Response `200`

Returned if the requested space role is retrieved.

- object
  - `id` string — The identifier for the space role.
  - `type` 'SYSTEM' | 'CUSTOM' — The role type.
  - `name` string — The name for the space role.
  - `description` string — The description for the space role’s usage.
  - `spacePermissions` string[] — The space permissions the space role is comprised of.
  - `_links` object
    - `base` string — Base url of the Confluence site.

## Other responses

- `400` — Returned if an invalid request is provided.
- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `404` — Returned if the calling user does not have permission to view the space role.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api-v2/revisions/c4bd1ed570f2/schema)