Verify a bank account
curl --request POST \
--url https://api.platnova.com/v1/banks/verify \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"account_number": "0123456789",
"bank_code": "044",
"country_code": "NG"
}
'import requests
url = "https://api.platnova.com/v1/banks/verify"
payload = {
"account_number": "0123456789",
"bank_code": "044",
"country_code": "NG"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({account_number: '0123456789', bank_code: '044', country_code: 'NG'})
};
fetch('https://api.platnova.com/v1/banks/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.platnova.com/v1/banks/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '0123456789',
'bank_code' => '044',
'country_code' => 'NG'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platnova.com/v1/banks/verify"
payload := strings.NewReader("{\n \"account_number\": \"0123456789\",\n \"bank_code\": \"044\",\n \"country_code\": \"NG\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.platnova.com/v1/banks/verify")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_number\": \"0123456789\",\n \"bank_code\": \"044\",\n \"country_code\": \"NG\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platnova.com/v1/banks/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"0123456789\",\n \"bank_code\": \"044\",\n \"country_code\": \"NG\"\n}"
response = http.request(request)
puts response.read_body{
"status": true,
"data": {
"account_number": "0123456789",
"account_name": "ADAEZE OBI",
"bank_code": "044",
"bank_status": {
"bank_code": "044",
"bank_name": "Access Bank",
"level": "green",
"message": "Transfers to Access Bank usually arrive in under a minute.",
"expected_minutes": 1,
"as_of": "2026-11-11T08:10:00Z"
}
},
"error": [],
"message": "operation was successful"
}{
"status": false,
"data": {
"code": "request_in_progress"
},
"error": [
"<string>"
],
"message": "<string>"
}Banks
Verify a Bank Account
Resolves an account number at a bank to the account holder’s name so you can show it before sending. Call this before every bank transfer; a wrong bank_code or account number is refused here rather than after the money has moved.
POST
/
v1
/
banks
/
verify
Verify a bank account
curl --request POST \
--url https://api.platnova.com/v1/banks/verify \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"account_number": "0123456789",
"bank_code": "044",
"country_code": "NG"
}
'import requests
url = "https://api.platnova.com/v1/banks/verify"
payload = {
"account_number": "0123456789",
"bank_code": "044",
"country_code": "NG"
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({account_number: '0123456789', bank_code: '044', country_code: 'NG'})
};
fetch('https://api.platnova.com/v1/banks/verify', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.platnova.com/v1/banks/verify",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'account_number' => '0123456789',
'bank_code' => '044',
'country_code' => 'NG'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platnova.com/v1/banks/verify"
payload := strings.NewReader("{\n \"account_number\": \"0123456789\",\n \"bank_code\": \"044\",\n \"country_code\": \"NG\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.platnova.com/v1/banks/verify")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"account_number\": \"0123456789\",\n \"bank_code\": \"044\",\n \"country_code\": \"NG\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platnova.com/v1/banks/verify")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"account_number\": \"0123456789\",\n \"bank_code\": \"044\",\n \"country_code\": \"NG\"\n}"
response = http.request(request)
puts response.read_body{
"status": true,
"data": {
"account_number": "0123456789",
"account_name": "ADAEZE OBI",
"bank_code": "044",
"bank_status": {
"bank_code": "044",
"bank_name": "Access Bank",
"level": "green",
"message": "Transfers to Access Bank usually arrive in under a minute.",
"expected_minutes": 1,
"as_of": "2026-11-11T08:10:00Z"
}
},
"error": [],
"message": "operation was successful"
}{
"status": false,
"data": {
"code": "request_in_progress"
},
"error": [
"<string>"
],
"message": "<string>"
}Overview
Resolves an account number at a bank to the account holder’s name. Show the name to whoever is paying before you send: a wrongbank_code or a mistyped account number is refused here, rather than after the money has moved.
bank_code must come from List banks for the same country_code.
For Nigerian accounts the answer also carries bank_status: how transfers to that bank are going right now, or null when we don’t know. It is the same object Bank network status returns. If it is red or amber, tell your customer and let them decide; it never blocks the payout.Body
application/json

