# List role bindings

**GET** `/admin/role-bindings`

:::code-group
```bash title="cURL"
curl --request GET \
  --url https://api.pinecone.io/admin/role-bindings \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Pinecone-Api-Version: <x-pinecone-api-version>'
```

```python title="Python"
import requests

url = "https://api.pinecone.io/admin/role-bindings"

headers = {
    "Authorization": "Bearer <token>",
    "X-Pinecone-Api-Version": "<x-pinecone-api-version>"
}

response = requests.get(url, headers=headers)

print(response.text)
```

```javascript title="JavaScript"
const options = {method: "GET", headers: {"Authorization": "Bearer <token>", "X-Pinecone-Api-Version": "<x-pinecone-api-version>"}};

fetch("https://api.pinecone.io/admin/role-bindings", options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

```php title="PHP"
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.pinecone.io/admin/role-bindings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "X-Pinecone-Api-Version: <x-pinecone-api-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
```

```go title="Go"
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.pinecone.io/admin/role-bindings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("X-Pinecone-Api-Version", "<x-pinecone-api-version>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

```java title="Java"
HttpResponse<String> response = Unirest.get("https://api.pinecone.io/admin/role-bindings")
  .header("Authorization", "Bearer <token>")
  .header("X-Pinecone-Api-Version", "<x-pinecone-api-version>")
  .asString();
```

```ruby title="Ruby"
require 'uri'
require 'net/http'

url = URI("https://api.pinecone.io/admin/role-bindings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Pinecone-Api-Version"] = '<x-pinecone-api-version>'

response = http.request(request)
puts response.read_body
```
:::

:::code-group
```json title="200"
{
  "data": [
    {
      "created_at": "2026-04-10T15:23:00.000Z",
      "id": "5a86ed21-daf1-448d-a9ca-f92a0fd839d3",
      "principal_id": "e2e92523-85dc-4142-b8c2-e681be8b78df",
      "principal_type": "user",
      "resource_id": "-ExampleOrgId0000000",
      "resource_type": "organization",
      "role": "OrgMember"
    }
  ],
  "pagination": {
    "next": "eyJsYXN0X2lkIjoiNWE4NmVkMjEifQ=="
  }
}
```

```json title="400"
{
  "error": {
    "code": "INVALID_ARGUMENT",
    "message": "Bad request. The request body included invalid request parameters."
  },
  "status": 400
}
```

```json title="401"
{
  "error": {
    "code": "UNAUTHENTICATED",
    "message": "Invalid API key."
  },
  "status": 401
}
```

```json title="403"
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "The index exceeds the project quota of 5 pods by 2 pods. Upgrade your account or change the project settings to increase the quota."
  },
  "status": 429
}
```

```json title="500"
{
  "error": {
    "code": "UNKNOWN",
    "message": "Internal server error"
  },
  "status": 500
}
```

```json title="4XX"
{
  "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "The index exceeds the project quota of 5 pods by 2 pods. Upgrade your account or change the project settings to increase the quota."
  },
  "status": 429
}
```
:::

#### Authorizations

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `Authorization` | `string` | - |  |

An [access token](/guides/admin-organizations-manage-service-accounts#retrieve-an-access-token) must be provided in the `Authorization` header using the `Bearer` scheme.

#### Headers

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `X-Pinecone-Api-Version` | `string` | `2026-07` | Required date-based version header |

#### Query Parameters

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `principal_type?` | `string` | - | Filter by principal type. Required when principal_id is set. Example: service_account |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `principal_id?` | `string` | - | Filter by principal ID. Requires principal_type. The ID is a UUID for all principal types (user, service account, or invite). |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `resource_type?` | `string` | - | Filter by resource type. Required when resource_id is set. Example: project |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `resource_id?` | `string` | - | Filter by resource ID. Requires resource_type. |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `role?` | `string` | - | Filter by role. Example: ProjectOwner |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `limit?` | `integer` | `100` | The number of results to return per page. When omitted, the server defaults to 100. Out-of-range values return 400 OUT_OF_RANGE. Required range: 1 <= x <= 100 |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `paginationToken?` | `string` | - | Cursor from pagination.next of a prior response. Must be reused with the same query context (path parameters, filters, and limit). |

#### Response

`200` — A paginated list of role bindings. When multiple filters are supplied, they are combined with AND.

A paginated list of role bindings.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `data` | `object[]` | - | The page of role bindings. |

:::accordion{title="Show child attributes"}
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `id` | `string` | - | The unique ID of the role binding. |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `principal_type` | `string` | - | The kind of principal that receives permissions from a role binding. Possible values: user, service_account, api_key, invite. Example: service_account |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `principal_id` | `string` | - | The principal's ID. A UUID for all principal types (user, service_account, api_key, invite). Example: e2e92523-85dc-4142-b8c2-e681be8b78df |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `resource_type` | `string` | - | The kind of resource scope a role binding applies to. Possible values: organization, project. Example: project |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `resource_id` | `string` | - | The organization or project that the binding is scoped to. |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `role` | `string` | - | A role assigned to a principal at a resource scope. Example: ProjectOwner |

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `created_at` | `string` | - | When the role binding was created. |
:::

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `pagination?` | `object \| null` | - | Cursor envelope for the next page. null (or absent) on the final page of results. |

:::accordion{title="Show child attributes"}
| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `next?` | `string` | - | Opaque cursor for the next page. Do not parse or construct. Invalid or expired tokens return 400. Example: eyJsYXN0X2lkIjogImluZGV4LTQifQ== |
:::

## Related pages

- [Create a role binding](./admin-2-role-bindings-create-a-role-binding.md)
- [Get role binding details](./admin-2-role-bindings-get-role-binding-details.md)
- [Delete a role binding](./admin-2-role-bindings-delete-a-role-binding.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.