GET
/
connection
curl --request GET \
  --url https://api.nango.dev/connection \
  --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

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.

Response

200 - application/json

Successfully returned a list of connections

The response is of type object.

GET
/
connection
curl --request GET \
  --url https://api.nango.dev/connection \
  --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

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.

Response

200 - application/json

Successfully returned a list of connections

The response is of type object.