---
title: "Resolve bank account"
method: POST
path: "/api/v1/bila/resolve/bank-account"
tags: ["Resolve"]
---

# Resolve bank account

`POST /api/v1/bila/resolve/bank-account`

## Request

- Base URL: `https://api.usebila.com`
- URL: `https://api.usebila.com/api/v1/bila/resolve/bank-account`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/docs/api/v1/bila/resolve/bank-account/post.ts> (a function with typed inputs; its response is checked against the schema)

Verify and retrieve bank account holder details

## Request body

- ResolveBankAccountDto
  - `accountNumber` string, required: Bank account number
  - `bankId` string, required: Bank ID
  - `country` 'zm' | 'ng': Country code

## Response `200`

Bank account resolved successfully

- object
  - `status` boolean, required: Request success status
  - `message` string, required: Response message
  - `data` ResolvedAccountResponseDto
    - `accountName` string, required: Account holder name
    - `accountNumber` string: Bank account number
    - `phone` string: Phone number
    - `operator` string: Mobile money operator
    - `bankId` string: Bank ID
    - `bankName` string: Bank name
    - `country` string, required: Country code

## Other responses

- `400`: Invalid account details or unable to resolve

## Changes

- **2026-10-16** `781041632c91`: 1 info
  - added the new `ng` enum value to the request property `country`
- **2026-06-05** `60e9d9bed8eb`: 1 breaking
  - removed the enum value `ng` of the request property `country`

[Operation history](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/changes/api/v1/bila/resolve/bank-account/post.md)

---

[API](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api.md) - [All operations](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bilasdk/apis/bila-payment-gateway-api/revisions/781041632c91?raw)