---
title: "Get account"
method: GET
path: "/accounts/{account_id}"
tags: ["Accounts"]
---

# Get account

`GET /accounts/{account_id}`

## Request

- Base URL: `https://api.truelayer-sandbox.com/data/v1`
- URL: `https://api.truelayer-sandbox.com/data/v1/accounts/{account_id}`
- Auth: OAuth 2
  - Authorization code: `https://auth.truelayer.com/token/connect`
  - Token URL: `https://auth.truelayer.com/token/connect` scopes: `accounts`

Get a specific account

## Path parameters

- `account_id` string, required

## Query parameters

- `async` 'true'
- `webhook_uri` string, uri

## Headers

- `X-Client-Correlation-Id` string
- `X-PSU-IP` string

## Response `200`

OK

- object
  - `results` Account[]
    - `update_timestamp` string, datetime, required: Last update time of the data
    - `account_id` string: Unique identifier of the account
    - `account_type` 'TRANSACTION' | 'SAVINGS' | 'BUSINESS_TRANSACTION' | 'BUSINESS_SAVINGS': Distinguish between personal and business, as well as savings and current accounts.
    - `display_name` string, required: Human-readable name of the account
    - `currency` 'EUR' | 'GBP' | 'USD' | 'AUD', required: Currency used for this account or transaction
    - `account_number` object, required
      - `number` string: Only returned for UK accounts
      - `sort_code` string: Only returned for UK accounts
      - `swift_bic` string: ISO 9362:2009 Business Identifier Codes. If a SWIFT BIC is not supported, one of the below values will be returned: `NOT_SUPPORTED_BY_GEO` or `NOT_SUPPORTED_BY_PROVIDER`
      - `iban` string: ISO 13616-1:2007 international bank number
      - `routing_number` string: Routing transit number. Only returned for US accounts
      - `bsb` string: BSB (Bank State Branch) number of the account. Only returned for AU accounts
    - `provider` object, required
      - `provider_id` string: Unique identifier for the provider
      - `logo_uri` string: Use the providers endpoint for accurate provider data
      - `display_name` string: Use the providers endpoint for accurate provider data
  - `status` 'Succeeded' | 'Queued' | 'Running' | 'Failed': Indicates whether the request was successful. 'Queued', 'Running' and 'Failed' can be returned for async requests.

## Other responses

- `202`: Accepted
- `401`: Unauthorized
- `403`: Access denied
- `404`: Not found
- `429`: Rate limit exceeded
- `500`: Internal server error
- `501`: Not implemented
- `503`: Service unavailable
- `504`: Gateway timeout

---

[API](https://skmtc.dev/truelayer/apis/data-api-v1.md) - [All operations](https://skmtc.dev/truelayer/apis/data-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/data-api-v1/revisions/2906fd6d5b2a?raw)
