---
title: "List role bindings"
method: GET
path: "/v2/role-bindings"
tags: ["Role Bindings"]
---

# List role bindings

`GET /v2/role-bindings`

List role bindings for the authenticated user's account, filtered by
resource type. Results are paginated; use `limit` and `cursor` for
subsequent pages.

The `resource_type` query parameter is **required** and must be one of
`SPACE` or `PROJECT`. All bindings in the account are visible to any
authenticated account member. Use `user_id` to narrow to a specific
user.

  <Note>This endpoint is in beta, read more [here](https://arize.com/docs/ax/rest-reference#api-version-stages).</Note>

## Query parameters

- `limit` integer
- `cursor` string
- `user_id` string — A universally unique identifier (base64-encoded opaque string).
- `resource_type` 'SPACE' | 'PROJECT', required — Resource type for the binding. Only `SPACE` and `PROJECT` are supported for single-binding CRUD. `resource_id` must encode the same resource type.

## Response `200`

Returns a list of role binding objects.

- ListRoleBindingsResponse
  - `role_bindings` RoleBinding[], required — A list of role bindings.
    - `id` string, required — Unique identifier for the role binding.
    - `role_id` string, required — A universally unique identifier (base64-encoded opaque string).
    - `user_id` string, required — A universally unique identifier (base64-encoded opaque string).
    - `resource_type` 'SPACE' | 'PROJECT', required — Resource type for the binding. Only `SPACE` and `PROJECT` are supported for single-binding CRUD. `resource_id` must encode the same resource type.
    - `resource_id` string, required — A universally unique identifier (base64-encoded opaque string).
    - `created_at` string, date-time, required — Timestamp when the binding was created.
    - `updated_at` string, date-time, required — Timestamp when the binding was last updated.
  - `pagination` PaginationMetadata, required — Cursor-based pagination metadata. Use `next_cursor` in the subsequent request's `cursor` query parameter.
    - `next_cursor` string — Opaque cursor for fetching the next page. Treat as an unreadable token. Present when `has_more` is true; omitted when `has_more` is false.
    - `has_more` boolean, required — True if another page of results is available.

## Other responses

- `400` — Invalid request
- `401` — Authentication is required
- `404` — Not found
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/arize-ai/apis/arize-rest-api.md) · [All operations](https://skmtc.net/arize-ai/apis/arize-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arize-ai/arize-rest-api/versions/1e87d8a4cf69/schema)