Endpoint
GET https://requiems.xyz/v1/finance/swift/{code}
Get SWIFT Code
Look up bank metadata for a SWIFT/BIC code.
Parameters
| Name | Type | Required | Location | Description |
|---|---|---|---|---|
code |
string | yes | path | SWIFT/BIC code (8 or 11 alphanumeric characters) |
Response Example
{
"data": {
"swift_code": "DEUTDEDBXXX",
"bank_code": "DEUT",
"country_code": "DE",
"location_code": "DB",
"branch_code": "XXX",
"bank_name": "Deutsche Bank AG",
"city": "Frankfurt am Main",
"country_name": "Germany",
"is_primary": true
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
swift_code |
string | Full 11-character SWIFT/BIC code |
bank_code |
string | Institution code (characters 1-4) |
country_code |
string | ISO 3166-1 alpha-2 country code (characters 5-6) |
location_code |
string | Location code (characters 7-8) |
branch_code |
string | Branch code (characters 9-11), XXX for primary office |
bank_name |
string | Bank or institution name |
city |
string | City of the branch or primary office |
country_name |
string | Full country name |
is_primary |
boolean | true when branch_code is XXX |
Errors
400bad_request — Invalid SWIFT/BIC format (must be 8 or 11 valid characters).404not_found — SWIFT/BIC code not found in the dataset.500internal_error — Unexpected server error.