Skip to main content
GET
/
connections
List connections
curl --request GET \
  --url https://api.nango.dev/connections \
  --header 'Authorization: Bearer <token>'
{
"connections": [
  {
    "id": 1,
    "connection_id": "test-1",
    "provider": "slack",
    "provider_config_key": "slack-nango-community",
    "created": "2023-06-03T14:53:22.051Z",
    "metadata": null,
    "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"
    },
    "errors": [],
    "end_user": {
      "id": "your-internal-id",
      "email": "user@example.com",
      "organization": {
        "id": "user-organization-id"
      }
    }
  }
]
}

{
"connections": [
  {
    "id": 1,
    "connection_id": "test-1",
    "provider": "slack",
    "provider_config_key": "slack-nango-community",
    "created": "2023-06-03T14:53:22.051Z",
    "metadata": null,
    "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"
    },
    "errors": [],
    "end_user": {
      "id": "your-internal-id",
      "email": "user@example.com",
      "organization": {
        "id": "user-organization-id"
      }
    }
  }
]
}

Authorizations

​
Authorization
string
header
required

The secret key from your Nango environment.

Query Parameters

​
connectionId
string

Will exactly match a given connectionId. Can return multiple connections with the same ID across integrations

​
search
string

Will partially match connection IDs or end user profiles.

​
endUserId
string

Filter the list of connections based on the given end user id.

​
endUserOrganizationId
string

Filter the list of connections based on the given end user's organization id.

​
limit
integer

Limit the number of connections returned

​
page
integer

Page number for paginated results

Response

Successfully returned a list of connections

​
connections
object[]