---
title: "List Bindings"
method: POST
path: "/api/v1/service_principals/bindings/list"
tags: ["Service Principal Binding"]
---

# List Bindings

`POST /api/v1/service_principals/bindings/list`

ListBindings returns every active binding held by a subject. Empty
 list when the subject is unbound. The response is unordered.

## Request body

- C1ApiServicePrincipalV1ServicePrincipalServiceListBindingsRequest — The ServicePrincipalServiceListBindingsRequest message.
  - `pageSize` integer — The pageSize field.
  - `pageToken` string — The pageToken field.
  - `subject` C1ApiServicePrincipalV1ServicePrincipalBindingSubject — ServicePrincipalBindingSubject identifies the entity that is bound to a service principal. Open-ended oneof so future subject kinds (workflows, connectors, etc.) can be added without changing the RPC shape. This message contains a oneof named kind. Only a single field of the following list may be set at a time: - functionId
    - `functionId` string, nullable — Function ID. The function authenticates outbound c1-api calls as user:<service_principal_id> instead of function:<function_id>. This field is part of the `kind` oneof. See the documentation for `c1.api.service_principal.v1.ServicePrincipalBindingSubject` for more details.

## Response `200`

Successful response

- C1ApiServicePrincipalV1ServicePrincipalServiceListBindingsResponse — The ServicePrincipalServiceListBindingsResponse message.
  - `bindings` C1ApiServicePrincipalV1ServicePrincipalBinding[], nullable — Active bindings held by the subject in this page. Empty when the subject is unbound. Order is unspecified.
    - `createdAt` string, date-time, nullable
    - `servicePrincipalId` string — The servicePrincipalId field.
    - `updatedAt` string, date-time, nullable
  - `nextPageToken` string — The nextPageToken field.

## Changes

- **2026-04-30** `fa2bb307d6fa` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/service_principals/bindings/list/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) · [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f76d07868c0c/schema)