---
title: "Retrieves the connections for this user"
method: GET
path: "/Connections"
tags: ["identity"]
---

# Retrieves the connections for this user

`GET /Connections`

## Request

- Base URL: `https://api.xero.com`
- URL: `https://api.xero.com/Connections`
- Auth: OAuth 2
  - Authorization code: `https://login.xero.com/identity/connect/authorize`
  - Token URL: `https://identity.xero.com/connect/token`

Override the base server url that include version

## Query parameters

- `authEventId` string, uuid

## Response `200`

Success - return response of type Connections array with 0 to n Connection

- Connection[]
  - `id` string, uuid: Xero identifier
  - `tenantId` string, uuid: Xero identifier of organisation
  - `authEventId` string, uuid: Identifier shared across connections authorised at the same time
  - `tenantType` string: Xero tenant type (i.e. ORGANISATION, PRACTICE)
  - `tenantName` string: Xero tenant name
  - `createdDateUtc` string, date-time: The date when the user connected this tenant to your app
  - `updatedDateUtc` string, date-time: The date when the user most recently connected this tenant to your app. May differ to the created date if the user has disconnected and subsequently reconnected this tenant to your app.

---

[API](https://skmtc.dev/xeroapi/apis/xero-oauth-2-identity-service-api.md) - [All operations](https://skmtc.dev/xeroapi/apis/xero-oauth-2-identity-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xeroapi/apis/xero-oauth-2-identity-service-api/revisions/eea0725c67bd?raw)