Sign in
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

Request

  • Base URL: https://api.getsafepay.com/raastwire
  • URL: https://api.getsafepay.com/raastwire/v1/aggregators/{raast-aggregator-id}/title-fetch/v2
  • Auth: API key in header X-SFPY-AGGREGATOR-SECRET-KEY

Query parameters

account_numberstring required
Example:1007079203

Conventional bank account number to fetch the registered account title for.

bank_namestring required
Example:bank_al_falah_limited

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.

Response

This response contains account title details fetched from Raast

api_versionstring

The current version of the API spec

Example response

{
  "api_version": "v1"
}

Changes

No recorded changes to this operation across all 1 revision of this API.