README

Saudi banks IBAN identifier lookup with English and Arabic names.

The library ships a small, typed dataset of every IBAN bank identifier used in Saudi Arabia, including legacy codes for merged banks. It exposes helpers to list all banks, resolve a bank from a two-digit IBAN identifier, or resolve directly from a full Saudi IBAN string.

Installation

composer require meita/saudi-banks

Usage

use Meita\SaudiBanks\Banks;

// Get every bank as value objects
$banks = Banks::all();

// Resolve by the two-digit IBAN identifier (positions 5-6 in SA IBANs)
$rajhi = Banks::findByIbanIdentifier('80');

// Resolve from a full IBAN (spaces are fine)
$fromIban = Banks::findByIban('SA03 8000 0000 6080 1016 7519');

// Export to array for JSON responses
header('Content-Type: application/json');
echo json_encode($fromIban->toArray(), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);

Data dictionary

Each record contains:

• iban_identifier — Two-digit IBAN bank identifier (string to preserve leading zeros).
• english_name — Formal English name.
• arabic_name — Formal Arabic name.
• short_name — Common ticker/short name.
• active — false for legacy identifiers that still exist on old IBANs.
• notes — Optional context.

Current coverage

If you spot an omission or change (e.g., new branches or retired identifiers), open a PR or file an issue.

Testing

composer install
./vendor/bin/phpunit

Tests validate uniqueness of identifiers, basic lookup helpers, and a sample IBAN parse.

License

MIT