Title Fetch V2
curl --request GET \
--url https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2 \
--header 'X-SFPY-AGGREGATOR-SECRET-KEY: <api-key>'import requests
url = "https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2"
headers = {"X-SFPY-AGGREGATOR-SECRET-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-SFPY-AGGREGATOR-SECRET-KEY': '<api-key>'}};
fetch('https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2', 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.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2",
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-SFPY-AGGREGATOR-SECRET-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.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-SFPY-AGGREGATOR-SECRET-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.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2")
.header("X-SFPY-AGGREGATOR-SECRET-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-SFPY-AGGREGATOR-SECRET-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"api_version": "v1",
"data": {
"statusCode": 0,
"acctitle": "Title-1 1007079203",
"acctype": "Account"
}
}Utilities
Title Fetch V2
Retrieve account title metadata for a conventional bank account number. Provide account_number and bank_name; Safepay resolves the receiver BIC internally before querying the Raast directory. Supported bank_name values and their BIC mappings are listed on this page. Account titles are sensitive personal data; keep this call in an authenticated backend flow and apply your own abuse-prevention limits.
GET
/
v1
/
aggregators
/
{raast-aggregator-id}
/
title-fetch
/
v2
Title Fetch V2
curl --request GET \
--url https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2 \
--header 'X-SFPY-AGGREGATOR-SECRET-KEY: <api-key>'import requests
url = "https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2"
headers = {"X-SFPY-AGGREGATOR-SECRET-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-SFPY-AGGREGATOR-SECRET-KEY': '<api-key>'}};
fetch('https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2', 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.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2",
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-SFPY-AGGREGATOR-SECRET-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.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-SFPY-AGGREGATOR-SECRET-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.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2")
.header("X-SFPY-AGGREGATOR-SECRET-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-SFPY-AGGREGATOR-SECRET-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"api_version": "v1",
"data": {
"statusCode": 0,
"acctitle": "Title-1 1007079203",
"acctype": "Account"
}
}bank_name must match one of the supported snake_case identifiers below. Unknown or misspelled bank names return a validation error.
Supported bank_name values
| bank_name | BIC |
|---|---|
| allied_bank_ltd | ABPAPKKA |
| accountant_general_pakistan_revenue | AGPRPKKA |
| summit_bank_limited | AHRBPKKA |
| bank_al_falah_limited | ALFHPKKA |
| askari_bank_ltd | ASCMPKKA |
| bank_al_habib_ltd | BAHLPKKA |
| bank_of_china | BKCHPKKA |
| bank_islami_pakistan_ltd | BKIPPKKA |
| the_bank_of_punjab | BPUNPKKA |
| central_depository_co_of_pakistan | CDCPKKAA |
| cga | CGAPKKAA |
| citi_bank_n_a | CITIPKKX |
| deutsche_bank_ag | DEUTPKKA |
| dubai_islamic_bank_pak_ltd | DUIBPKKA |
| al_baraka_bank_pakistan_ltd | EGIBPKKA |
| faysal_bank_limited | FAYSPKKA |
| central_directorate_of_national_savings | FGCDNSZB |
| finca_microfinance_bank | FINCAMFB |
| hbl_micro_finance_bank_ltd | FMICFBPK |
| first_women_bank_limited | FWOMPKKA |
| habib_bank_limited | HABBPKKARTG |
| industrial_and_commercial_bank_of_china_ltd | ICBKPKKA |
| js_bank_limited | JSBLPKKA |
| khushali_bank_limited | KHBLDFID |
| the_bank_of_khyber_ltd | KHYBPKKA |
| samba_bank_limited | MBPLPKKA |
| mcb_islamic_bank | MCIBPKKI |
| meezan_bank_limited | MEZNPKKA |
| habib_metropolitan_bank_ltd | MPBLPKKA |
| mcb_bank_ltd | MUCBPKKKRTG |
| national_bank_of_pakistan | NBPBPKKA |
| apna_microfinance_bank_ltd | NMICFBPK |
| nrsp_microfinance_bank | NRSPMFBB |
| silkbank_limited | SAUDPKKA |
| state_bank_of_pakistan | SBPPPKKA |
| standard_chartered_bank_pakistan | SCBLPKKA |
| sindh_bank_limited | SINDPKKA |
| sme_bank_limited | SMESPKKA |
| soneri_bank_ltd | SONEPKKA |
| telenor_micro_finance_bank_limited | TMICFBPK |
| uat_participant | UATPKKHH |
| u_microfinance_bank_ltd | UMBLPKKA |
| united_bank_limited | UNILPKKARTG |
| mobilink_micro_finance_bank_ltd | WMBLPKKA |
| zarai_taraqiati_bank_ltd_karachi | ZTBLPKKA |
| nayapay | NPAYPKKA |
| sadapay | SADAPKKA |
| mashreq_bank | MSHQPKKA |
| rupin | RUPIPKKA |
Authorizations
Path Parameters
The unique identifier for the aggregator
Example:
"agg_2288490a-2176-4de5-b373-0ffb6f8e2e6e"
Query Parameters
Conventional bank account number to fetch the registered account title for.
Example:
"1007079203"
Snake_case identifier of the beneficiary's bank institution (e.g. bank_al_falah_limited). Must match one of the supported values listed on this page. Used to resolve the receiver BIC internally; unknown bank names return a validation error.
Example:
"bank_al_falah_limited"
Was this page helpful?