---
title: "Retrieve Bank Account Data"
method: GET
path: "/v1/users/{userId}/bankAccounts/{bankAccountId}/lookup/{extRequestId}"
tags: ["Real-Time Data"]
---

# Retrieve Bank Account Data

`GET /v1/users/{userId}/bankAccounts/{bankAccountId}/lookup/{extRequestId}`

## Request

- Base URL: `https://sandbox-api.spinwheel.io`
- URL: `https://sandbox-api.spinwheel.io/v1/users/{userId}/bankAccounts/{bankAccountId}/lookup/{extRequestId}`
- Auth: API key in header `Authorization`

Get the status of a real time balance lookup

## Path parameters

- `userId` string, required
- `bankAccountId` string, required
- `extRequestId` string, required

## Response `200`

Successful response

- BankAccountTransactionStatusResponse
  - `status` ResponseStatus, required
    - `code` number
    - `desc` string
    - `messages` Message[]
      - `desc` string, required
      - `type` 'ERROR' | 'WARN' | 'INFO'
  - `data` BankAccountTransactionStatusResponseData, required
    - `refreshTransactionStatus` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED', required: The status of the transaction
    - `refreshTransactionId` string, required: The id of the asyncronous transaction
    - `extRequestId` string, required: The external id for the refresh
    - `userId` string, required: The id of the user for the bank account
    - `bankAccountId` string, required: Id of the bank account
    - `nextEligibleRefreshOn` number, nullable: The earliest timestamp that the capability will be available, if applicable.
    - `results` BankAccountLookupResultsResponseData, required
      - `accountBalance` number, nullable

---

[API](https://skmtc.dev/spinwheel/apis/optimize.md) - [All operations](https://skmtc.dev/spinwheel/apis/optimize/llms.txt) - [OpenAPI document](https://skmtc.dev/spinwheel/apis/optimize/revisions/6222309663d2?raw)