---
title: "Get user data by connected account"
method: GET
path: "/accounts"
tags: ["User Data"]
---

# Get user data by connected account

`GET /accounts`

## Request

- Base URL: `https://api.truelayer-sandbox.com/signup-plus`
- URL: `https://api.truelayer-sandbox.com/signup-plus/accounts`
- Auth: HTTP bearer

Get user data from a connected account.

## Query parameters

- `account_id` string

## Response `200`

Success

- union
  - User
    - `title` string: Title
    - `first_name` string: User first name
    - `last_name` string: User last name
    - `date_of_birth` string: User Date Of Birth, formatted as an ISO 8601 string `YYYY-MM-DD`
    - `address` object: User address
      - `address_line1` string: the full street address including house number and street name
      - `address_line2` string: further details like building name, suite, apartment number, etc.
      - `city` string: name of the city / locality
      - `state` string: name of the county / state
      - `zip` string: zip code or postal code
      - `country_code` string: the country code according to [ISO-3166-1-alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
    - `national_identification_number` string: User national identification number (**available in Finland only**)
    - `sex` string: Sex of the user (**available in Finland only**)
    - `account_details` object: User account details
      - `account_number` string: The account number.
      - `sort_code` string: Sort code of account.
      - `iban` string: Accounts IBAN number.
      - `provider_id` string: The name of the bank.
  - MultipleAccountsLinked
    - `result` string: Value set to `multiple_accounts_linked`
    - `detail` string: Human readable description of next action to take
    - `links` object: Link to return to for each account, keyed by account ID.
    - `accounts` object[]: Valid linked accounts that can be used to retrieve user data.
      - `account_id` string: An identifier for the account, to be returned with the following request to get user data.
      - `currency` string: Currency of account.
      - `account_type` string: Type of the account returned by the bank.
      - `display_name` string: Name of the account returned by the bank.
      - `iban` string: Accounts IBAN number.
      - `swift_bic` string: SWIFT code of account.
      - `account_number` string: The account number.
      - `sort_code` string: Sort code of account.

## Other responses

- `400`: Invalid parameters
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `504`: Provider Timeout

---

[API](https://skmtc.dev/truelayer/apis/signup.md) - [All operations](https://skmtc.dev/truelayer/apis/signup/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/signup/revisions/daf354fea7ba?raw)