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

# Get user data by connected account

`GET /accounts`

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.net/truelayer/apis/authentication-server.md) · [All operations](https://skmtc.net/truelayer/apis/authentication-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truelayer/authentication-server/revisions/5f6051515b2c/schema)