---
title: "List organization roles"
method: GET
path: "/v1/roles"
tags: ["Role Management"]
---

# List organization roles

`GET /v1/roles`

Lists built-in roles and Enterprise custom roles for the authenticated organization.

## Query parameters

- `org_id` string
- `role_type` 'all' | 'system' | 'custom'
- `include_permissions` boolean
- `include_user_count` boolean

## Response `200`

Successfully retrieved roles

---

[API](https://skmtc.net/coderabbit/apis/coderabbit-api-spec.md) · [All operations](https://skmtc.net/coderabbit/apis/coderabbit-api-spec/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coderabbit/coderabbit-api-spec/versions/401789d85d01/schema)