Bank network status
curl --request GET \
--url https://api.platnova.com/v1/banks/status \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.platnova.com/v1/banks/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.platnova.com/v1/banks/status', 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/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.platnova.com/v1/banks/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.platnova.com/v1/banks/status")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platnova.com/v1/banks/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": true,
"data": {
"as_of": "2026-11-11T08:10:00Z",
"banks": [
{
"bank_code": "000015",
"bank_name": "Zenith Bank",
"level": "amber",
"message": "Zenith Bank is slow right now. Transfers are taking about 8 minutes.",
"expected_minutes": 8,
"as_of": "2026-11-11T08:10:00Z"
}
]
},
"error": [],
"message": "operation was successful"
}{
"status": false,
"data": {
"code": "request_in_progress"
},
"error": [
"<string>"
],
"message": "<string>"
}{
"status": false,
"data": {
"code": "request_in_progress"
},
"error": [
"<string>"
],
"message": "<string>"
}Banks
Bank Network Status
How transfers to each Nigerian bank are going right now: usually instant, slow, having problems, or no recent data. Use it to warn your customer before they send to a bank that is struggling, or to explain a slow payout. It never blocks a payout. Answers are cached for 60 seconds; polling faster returns the same answer.
GET
/
v1
/
banks
/
status
Bank network status
curl --request GET \
--url https://api.platnova.com/v1/banks/status \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.platnova.com/v1/banks/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.platnova.com/v1/banks/status', 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/status",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.platnova.com/v1/banks/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.platnova.com/v1/banks/status")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.platnova.com/v1/banks/status")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": true,
"data": {
"as_of": "2026-11-11T08:10:00Z",
"banks": [
{
"bank_code": "000015",
"bank_name": "Zenith Bank",
"level": "amber",
"message": "Zenith Bank is slow right now. Transfers are taking about 8 minutes.",
"expected_minutes": 8,
"as_of": "2026-11-11T08:10:00Z"
}
]
},
"error": [],
"message": "operation was successful"
}{
"status": false,
"data": {
"code": "request_in_progress"
},
"error": [
"<string>"
],
"message": "<string>"
}{
"status": false,
"data": {
"code": "request_in_progress"
},
"error": [
"<string>"
],
"message": "<string>"
}Overview
How transfers to each Nigerian bank are going right now. When a bank is slow or having problems, tell your customer before they send, and let them choose: send anyway, or pay into another account. A status never blocks a payout.level | What it means | Suggested label |
|---|---|---|
green | Transfers arrive as usual (expected_minutes is the typical time) | Usually instant, or “Usually ~N min” when expected_minutes is over 1 |
amber | Slow right now; expected_minutes says how slow | Slow right now |
red | Having problems; a transfer may be delayed | Having problems |
grey | No recent transfer data | No recent data |
message to your customer as it is. It is written for them and never names a payment provider.
Pass bank_code for one bank, as you hold it: the code from List banks, or one saved on a beneficiary. banks is empty when we know nothing about that code. Without bank_code you get every bank we have a status for; a bank can appear under more than one code.
Verify a bank account returns the same object as bank_status for Nigerian accounts, so you can show it right after the account name.
Caching
The status is recomputed every few minutes. Answers are cached for 60 seconds (Cache-Control: public, max-age=60), so polling more often than once a minute returns the same answer. A status older than 10 minutes is reported as grey.
If the status can’t be read, the endpoint answers 503. Treat that as “no status” and carry on with the payout.
