---
title: "Get role binding details"
method: GET
path: "/admin/role-bindings/{role_binding_id}"
tags: ["Role Bindings"]
---

# Get role binding details

`GET /admin/role-bindings/{role_binding_id}`

Get a role binding in the caller's organization by ID.

## Path parameters

- `role_binding_id` string, uuid, required

## Headers

- `X-Pinecone-Api-Version` string, required

## Response `200`

The role binding.

- RoleBinding — Grants a `role` to a `principal` at a `resource` scope.
  - `id` string, uuid, required — The unique ID of the role binding.
  - `principal_type` string, required — The kind of principal that receives permissions from a role binding. Possible values: `user`, `service_account`, `api_key`, `invite`.
  - `principal_id` string, required — The principal's ID. A UUID for all principal types (`user`, `service_account`, `api_key`, `invite`).
  - `resource_type` string, required — The kind of resource scope a role binding applies to. Possible values: `organization`, `project`.
  - `resource_id` string, required — The organization or project that the binding is scoped to.
  - `role` string, required — A role assigned to a principal at a resource scope.
  - `created_at` string, date-time, required — When the role binding was created.

## Other responses

- `401` — Unauthorized. Possible causes: Invalid API key.
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error.
- `4XX` — Unexpected error on request.

---

[API](https://skmtc.net/pinecone/apis/pinecone-admin-api.md) · [All operations](https://skmtc.net/pinecone/apis/pinecone-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinecone/pinecone-admin-api/versions/8210e9d414c2/schema)