> ## Documentation Index
> Fetch the complete documentation index at: https://www.c1.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List Bindings

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



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/service_principals/bindings/list
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/service_principals/bindings/list:
    post:
      tags:
        - Service Principal Binding
      summary: List Bindings
      description: |-
        ListBindings returns every active binding held by a subject. Empty
         list when the subject is unbound. The response is unordered.
      operationId: c1.api.service_principal.v1.ServicePrincipalService.ListBindings
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.service_principal.v1.ServicePrincipalServiceListBindingsRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.service_principal.v1.ServicePrincipalServiceListBindingsResponse
          description: Successful response
      x-codeSamples:
        - lang: go
          label: ListBindings
          source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"log\"\n)\n\nfunc main() {\n    ctx := context.Background()\n\n    s := conductoronesdkgo.New(\n        conductoronesdkgo.WithSecurity(shared.Security{\n            BearerAuth: \"<YOUR_BEARER_TOKEN_HERE>\",\n            Oauth: \"<YOUR_OAUTH_HERE>\",\n        }),\n    )\n\n    res, err := s.Principal.ListBindings(ctx, nil)\n    if err != nil {\n        log.Fatal(err)\n    }\n    if res.ServicePrincipalServiceListBindingsResponse != nil {\n        // handle response\n    }\n}"
        - lang: typescript
          label: Typescript (SDK)
          source: >-
            import { ConductoroneSDKTypescript } from
            "conductorone-sdk-typescript";


            const conductoroneSDKTypescript = new ConductoroneSDKTypescript({
              security: {
                bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
                oauth: "<YOUR_OAUTH_HERE>",
              },
            });


            async function run() {
              const result = await conductoroneSDKTypescript.principal.listBindings();

              console.log(result);
            }


            run();
components:
  schemas:
    c1.api.service_principal.v1.ServicePrincipalServiceListBindingsRequest:
      description: The ServicePrincipalServiceListBindingsRequest message.
      properties:
        pageSize:
          description: The pageSize field.
          format: int32
          readOnly: false
          type: integer
        pageToken:
          description: The pageToken field.
          readOnly: false
          type: string
        subject:
          $ref: >-
            #/components/schemas/c1.api.service_principal.v1.ServicePrincipalBindingSubject
      title: Service Principal Service List Bindings Request
      type: object
      x-speakeasy-name-override: ServicePrincipalServiceListBindingsRequest
    c1.api.service_principal.v1.ServicePrincipalServiceListBindingsResponse:
      description: The ServicePrincipalServiceListBindingsResponse message.
      properties:
        bindings:
          description: |-
            Active bindings held by the subject in this page. Empty when the
             subject is unbound. Order is unspecified.
          items:
            $ref: >-
              #/components/schemas/c1.api.service_principal.v1.ServicePrincipalBinding
          nullable: true
          readOnly: false
          type: array
        nextPageToken:
          description: The nextPageToken field.
          readOnly: false
          type: string
      title: Service Principal Service List Bindings Response
      type: object
      x-speakeasy-name-override: ServicePrincipalServiceListBindingsResponse
    c1.api.service_principal.v1.ServicePrincipalBindingSubject:
      description: >
        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
      properties:
        functionId:
          description: >-
            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.
          nullable: true
          readOnly: false
          type: string
      title: Service Principal Binding Subject
      type: object
      x-speakeasy-name-override: ServicePrincipalBindingSubject
    c1.api.service_principal.v1.ServicePrincipalBinding:
      description: |-
        ServicePrincipalBinding is one row in the binding store, naming a
         subject's link to a single service principal.
      properties:
        createdAt:
          format: date-time
          readOnly: false
          type: string
        servicePrincipalId:
          description: The servicePrincipalId field.
          readOnly: false
          type: string
        updatedAt:
          format: date-time
          readOnly: false
          type: string
      title: Service Principal Binding
      type: object
      x-speakeasy-name-override: ServicePrincipalBinding
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````