View Bank Account

Retrieves details of a specific bank account by its ID.

GET /api/v1/services/user/view-bank-account/{account-id}

cURL GET

[https://finlend.fincode.software/api/v1/services/user/view-bank-account/{account-id}](https://finlend.fincode.software/api/v1/services/user/view-bank-account/{account-id})

200

{
  "status": "<string>",
  "data": {
    "accountId": "<string>",
    "customerId": "<string>",
    "accountNumber": "<string>",
    "accountName": "<string>",
    "bankCode": "<string>",
    "bankName": "<string>",
    "accountType": "<string>",
    "isDefault": true,
    "isVerified": true,
    "createdDate": "<string>"
  }
}

Fetches detailed information about a bank account registered by the customer.

cURL GET

[https://finlend.fincode.software/api/v1/services/user/view-bank-account/{account-id}](https://finlend.fincode.software/api/v1/services/user/view-bank-account/{account-id})

Request Headers

X-Auth-Token · string · required

The JWT Access Token obtained from the /login or /refresh-token endpoint.

x-fapi-auth-date · string · required

The date and time at which the request was initiated (ISO 8601 format).

x-fapi-customer-ip-address · string · required

The IP address of the customer making the request.

x-fapi-interaction-id · string · required

Unique identifier for the interaction/session.

Path Parameters

account-id · string · required

The unique identifier (UUID) of the bank account to retrieve.

Response

Returns bank account details.

status · string · default: "SUCCESS"

Overall status of the API request.

data · object

Bank account details.

Show data object

accountId · string

Unique identifier for the bank account.

customerId · string

Identifier of the customer.

accountNumber · string

Bank account number (may be masked).

accountName · string

Account holder name.

bankCode · string

Bank code.

bankName · string

Bank name.

accountType · string

Type of account.

isDefault · boolean

Whether this is the default account.

isVerified · boolean

Whether the account has been verified.

createdDate · string

Date when the account was added.

Code Examples

cURL

curl --location 'https://finlend.fincode.software/api/v1/services/user/view-bank-account/123e4567-e89b-12d3-a456-426614174000' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345'