Learn how to use Swift correspondent banking rule objects.
Correspondent banking rules represent the configuration of a Swift customer with its correspondent banks. It lets Swift customer decide which correspondent banks and accounts to use depending on the payments' currency.
Below are details of the correspondent banking rule object properties:
| Attribute | Description |
|---|---|
| id string | The correspondent banking rule ID. |
| object string | Always correspondent_banking_rule. |
| status string | The correspondent bank status. Either active or disabled. |
| currency string | The target payment currency for the rule. It can either be a single ISO 4217 currency code (e.g "EUR" or "USD"), or a wildcard ("*"). Only one wildcard correspondent banking rule can be active at a given point of time. |
| correspondent_bank_id string | The UUID of the correspondent bank to use for Swift payments the chosen currency. |
| correspondent_bank_account_id string | The UUID of the correspondent bank account to use for Swift payments the chosen currency. This property. is optional. |
| created_at datetime | The creation date of the correspondent banking rule record. |
Below is an example of a correspondent bank:
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"object": "correspondent_banking_rule",
"status": "active",
"currency": "USD",
"correspondent_bank_id": "c3082086-321d-435e-ae24-b47ea74c1c21",
"correspondent_bank_account_id": "93fa776f-b24b-4188-8e14-5194401341ac",
"created_at": "2026-08-19T10:26:17.161Z"
}