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

# List connections (deprecated)

> Returns a list of connections without credentials. This endpoint is deprecated, use the /connections endpoint instead.

<Info>
  Requires an API key with one of: `environment:connections:list` or `environment:connections:list_credentials`. [Learn more about API key scopes](/reference/backend/http-api/api-keys#scopes).
</Info>

<ResponseExample>
  ```json Example Response theme={null}
  {
  "connections": [
    {
      "id": 1,
      "connection_id": "test-1",
      "provider": "slack",
      "provider_config_key": "slack-nango-community",
      "created": "2023-06-03T14:53:22.051Z",
      "metadata": null,
      "tags": {
        "end_user_id": "your-internal-id",
        "end_user_email": "user@example.com",
        "organization_id": "user-organization-id"
      },
      "errors": [{ "type": "auth", "log_id": "VrnbtykXJFckCm3HP93t"}]
    },
    {
      "id": 2,
      "connection_id": "test-2",
      "provider": "slack",
      "provider_config_key": "slack-nango-community",
      "created": "2023-06-03T15:00:14.945Z",
      "metadata": {
        "bot_id": "some-uuid"
      },
      "tags": {
        "end_user_id": "your-internal-id",
        "end_user_email": "user@example.com",
        "organization_id": "user-organization-id"
      },
      "errors": []
    }
  ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /connection
openapi: 3.1.0
info:
  title: Nango API
  description: Nango API specs used to authorize & sync data with external APIs.
  version: 1.0.0
servers:
  - url: https://api.nango.dev
    description: Production server
  - url: http://localhost:3003
    description: Local server
security:
  - bearerAuth: []
externalDocs:
  url: https://nango.dev/docs/reference/backend/http-api/authentication
paths:
  /connection:
    get:
      summary: List connections (deprecated)
      description: >-
        Returns a list of connections without credentials. This endpoint is
        deprecated, use the /connections endpoint instead.
      parameters:
        - name: connectionId
          in: query
          schema:
            type: string
          description: >-
            Will exactly match a given connectionId. Can return multiple
            connections with the same ID across integrations
        - name: search
          in: query
          schema:
            type: string
          description: Will partially match connection IDs or end user profiles.
        - name: endUserId
          in: query
          deprecated: true
          schema:
            type: string
          description: >-
            Deprecated. Prefer filtering connections by tag (e.g.
            `tags[end_user_id]=...`).
        - name: endUserOrganizationId
          in: query
          deprecated: true
          schema:
            type: string
          description: >-
            Deprecated. Prefer filtering connections by tag (e.g.
            `tags[organization_id]=...`).
        - name: tags
          in: query
          description: >-
            Filter the list of connections based on connection tags. All
            provided tags must match.
          style: deepObject
          explode: true
          schema:
            $ref: '#/components/schemas/Tags'
        - name: limit
          in: query
          schema:
            type: integer
          description: Limit the number of connections returned
        - name: page
          in: query
          schema:
            type: integer
          description: Page number for paginated results
      responses:
        '200':
          description: Successfully returned a list of connections
          content:
            application/json:
              schema:
                type: object
                required:
                  - connections
                properties:
                  connections:
                    type: array
                    items:
                      type: object
                      required:
                        - id
                        - connection_id
                        - provider
                        - provider_config_key
                        - created
                        - metadata
                        - tags
                        - errors
                      properties:
                        id:
                          type: integer
                          description: The internal Nango ID used for the connection.
                        connection_id:
                          type: string
                          description: The connection ID used to create the connection.
                        provider:
                          type: string
                          description: The Nango API Configuration.
                        provider_config_key:
                          type: string
                          description: >-
                            The integration ID used to create the connection
                            (aka Unique Key, Provider Config Key).
                        created:
                          type: string
                          description: Connection creation date.
                        metadata:
                          anyOf:
                            - type: object
                            - type: 'null'
                          description: Custom metadata attached to the connection
                        tags:
                          $ref: '#/components/schemas/Tags'
                        errors:
                          type: array
                          items:
                            $ref: '#/components/schemas/ConnectionError'
                          description: >
                            List of connection errors. Ex:

                            - Connection credentials are invalid (type=auth)

                            - Last sync for the connection has failed
                            (type=sync)
                        end_user:
                          deprecated: true
                          anyOf:
                            - $ref: '#/components/schemas/ConnectionEndUser'
                            - type: 'null'
components:
  schemas:
    Tags:
      type: object
      description: Connection tags (key/value strings). Keys are normalized to lowercase.
      maxProperties: 10
      additionalProperties:
        type: string
        maxLength: 255
    ConnectionError:
      type: object
      required:
        - type
        - log_id
      properties:
        type:
          type: string
          enum:
            - auth
            - sync
          example: auth
        log_id:
          type: string
          example: VrnbtykXJFckCm3HP93t
    ConnectionEndUser:
      type: object
      deprecated: true
      required:
        - id
      properties:
        id:
          type: string
          description: Uniquely identifies the end user.
          deprecated: true
        email:
          anyOf:
            - type: string
            - type: 'null'
          deprecated: true
        display_name:
          anyOf:
            - type: string
            - type: 'null'
          deprecated: true
        tags:
          type: object
          additionalProperties: true
          description: >-
            Tags associated with the end user. Only accepts strings values, up
            to 64 keys.
          deprecated: true
        organization:
          deprecated: true
          anyOf:
            - type: object
              required:
                - id
              properties:
                id:
                  type: string
                  description: Uniquely identifies the organization the end user belongs to
                display_name:
                  anyOf:
                    - type: string
                    - type: 'null'
            - type: 'null'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: The secret key from your Nango environment.

````