---
descriptions:
  list_connections:
    data: >-
      An array of [Connections](/reference/sso/connection) ordered by creation
      time.
    connection_type: Filter Connections by their type.
    organization_id: Filter Connections by their associated organization.
    domain: Filter Connections by their associated domain.
reference:
  curl:
    - key: listConnections
      id: list_connections
      url: /reference/sso/connection/list
      title: /connections
      type: GET
      parameters:
        - key: connection_type
          optional: true
          type: string
          description: (list_connections.connection_type)
        - key: domain
          optional: true
          type: string
          description: (list_connections.domain)
        - key: organization_id
          optional: true
          type: string
          description: (list_connections.organization_id)
        - (after)
        - (before)
        - (limit)
        - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_connections.data)
            - key: list_metadata
              type: object
              properties:
                - (before)
                - (after)
  dotnet:
    - key: ListConnections
      id: list_connections
      url: /reference/sso/connection/list
      title: ssoService.ListConnections()
      parameters:
        - key: options
          type: ListConnectionsOptions
          expanded: true
          properties:
            - key: Type
              optional: true
              type: string
              description: (list_connections.connection_type)
            - key: Domain
              optional: true
              type: string
              description: (list_connections.domain)
            - key: OrganizationId
              optional: true
              type: string
              description: (list_connections.organization_id)
            - (Limit)
            - (Before)
            - (After)
            - (Order)
        - (cancellationToken)
      returns:
        - key: Task<WorkOSList<Connection>>
          expanded: true
          properties:
            - key: Data
              type: List<Connection>
              description: (list_connections.data)
            - key: ListMetadata
              type: ListMetadata
              properties:
                - (Before)
                - (After)
  ruby:
    - key: list_connections
      id: list_connections
      url: /reference/sso/connection/list
      title: SSO.list_connections()
      parameters:
        - key: connection_type
          optional: true
          type: String
          description: (list_connections.connection_type)
        - key: domain
          optional: true
          type: String
          description: (list_connections.domain)
        - key: organization_id
          optional: true
          type: String
          description: (list_connections.organization_id)
        - (after)
        - (before)
        - (limit)
        - (order)
      returns:
        - key: anonymous
          type: Struct
          unwrap: true
          properties:
            - key: data
              type: 'Array[Connection]'
              description: (list_connections.data)
            - key: list_metadata
              type: Hash
              properties:
                - (before)
                - (after)
  php:
    - key: listConnections
      id: list_connections
      url: /reference/sso/connection/list
      title: $sso->listConnections()
      parameters:
        - key: connectionType
          optional: true
          type: string
          description: (list_connections.connection_type)
        - key: domain
          optional: true
          type: string
          description: (list_connections.domain)
        - key: organizationId
          optional: true
          type: string
          description: (list_connections.organization_id)
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: array
          unwrap: true
          properties:
            - key: data
              type: 'Connection[]'
              description: (list_connections.data)
            - (before)
            - (after)
  python:
    - key: list_connections
      id: list_connections
      url: /reference/sso/connection/list
      title: sso.list_connections()
      parameters:
        - key: connection_type
          optional: true
          type: str
          description: (list_connections.connection_type)
        - key: domain
          optional: true
          type: str
          description: (list_connections.domain)
        - key: organization_id
          optional: true
          type: str
          description: (list_connections.organization_id)
        - (after)
        - (before)
        - (limit)
        - (order)
      returns:
        - key: anonymous
          type: WorkOSListResource
          unwrap: true
          properties:
            - key: data
              type: 'list[ConnectionWithDomains]'
              description: (list_connections.data)
            - key: list_metadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
  js:
    - key: listConnections
      id: list_connections
      url: /reference/sso/connection/list
      title: sso.listConnections()
      parameters:
        - key: options
          type: object
          unwrap: true
          properties:
            - key: connectionType
              optional: true
              type: string
              description: (list_connections.connection_type)
            - key: domain
              optional: true
              type: string
              description: (list_connections.domain)
            - key: organizationId
              optional: true
              type: string
              description: (list_connections.organization_id)
            - (after)
            - (before)
            - (limit)
            - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'Connection[]'
              description: (list_connections.data)
            - key: listMetadata
              type: object
              properties:
                - (before)
                - (after)
  go:
    - key: ListConnections
      id: list_connections
      url: /reference/sso/connection/list
      title: sso.ListConnections()
      parameters:
        - (ctx)
        - key: opts
          type: sso.ListConnectionsOpts
          expanded: true
          properties:
            - key: ConnectionType
              optional: true
              type: string
              description: (list_connections.connection_type)
            - key: Domain
              optional: true
              type: string
              description: (list_connections.domain)
            - key: OrganizationID
              optional: true
              type: string
              description: (list_connections.organization_id)
            - (Limit)
            - (Before)
            - (After)
            - (Order)
      returns:
        - key: list
          type: sso.ListConnectionsResponse
          expanded: true
          properties:
            - key: Data
              type: '[]sso.Connection'
              description: (list_connections.data)
            - key: ListMetadata
              type: common.ListMetadata
              properties:
                - (Before)
                - (After)
        - (err)
  java:
    - key: listConnections
      id: list_connections
      url: /reference/sso/connection/list
      title: sso.listConnections()
      parameters:
        - key: options
          type: ListConnectionsOptions
          expanded: true
          properties:
            - key: connectionType
              optional: true
              type: String
              description: (list_connections.connection_type)
            - key: domain
              optional: true
              type: String
              description: (list_connections.domain)
            - key: organizationId
              optional: true
              type: String
              description: (list_connections.organization_id)
            - (limit)
            - (before)
            - (after)
            - (order)
            - key: builder()
              type: ListConnectionsOptionsBuilder
              description: (java.builder)
      returns:
        - key: connectionList
          type: ConnectionList
          expanded: true
          properties:
            - key: data
              type: List<Connection>
              description: (list_connections.data)
            - key: listMetadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
originalPath: .tmp-workos-clone/packages/docs/content/reference/sso/connection/list.mdx
---

## List Connections

Get a list of all of your existing connections matching the criteria specified.

<CodeBlock referenceId="list_connections">
  <CodeBlockTab title="Request" file="list-connections-request" />
  <CodeBlockTab title="Response" file="list-connections-response" />
</CodeBlock>