---
title: "Get Account Name Enquiry"
method: POST
path: "/payaza-account/api/v1/mainaccounts/merchant/provider/enquiry"
tags: ["Transfers"]
---

# Get Account Name Enquiry

`POST /payaza-account/api/v1/mainaccounts/merchant/provider/enquiry`

The Account Name Enquiry API is used to retrieve the account details of a beneficiary using its account number.

## Request body

- GetAccountNameEnquiryRequest
  - `service_payload` object — It contains the details of the service payload.
    - `currency` string, required — The currency code (e.g., NGN)
    - `bank_code` string, required — The unique code of the bank
    - `account_number` string, required — The customer's account number

## Response `200`

Response

- GetAccountNameEnquiryResponse
  - `response_code` integer
  - `response_message` string
  - `response_content` object
    - `account_number` string
    - `account_name` string
    - `bank_code` string
    - `account_status` string

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/revisions/1ecd4b94ff07/schema)
