From 5490e7e9ce6105708fd5ee58f069b78494a9e83a Mon Sep 17 00:00:00 2001
From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com>
Date: Tue, 19 May 2026 09:18:25 +0000
Subject: [PATCH] docs: add SWIFT_ACCOUNT to docs and Grid Visualizer

Sync documentation with recent OpenAPI schema changes from #473.

- Add SWIFT_ACCOUNT to Grid Visualizer account-types.ts
- Add SWIFT tab to external-accounts.mdx snippet with examples
- Add SWIFT tab to account-model.mdx with schema example

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 .../grid-visualizer/src/data/account-types.ts | 10 +++
 .../core-concepts/account-model.mdx           | 16 +++++
 mintlify/snippets/external-accounts.mdx       | 72 +++++++++++++++++++
 3 files changed, 98 insertions(+)

diff --git a/components/grid-visualizer/src/data/account-types.ts b/components/grid-visualizer/src/data/account-types.ts
index bd52ca54..08e7a740 100644
--- a/components/grid-visualizer/src/data/account-types.ts
+++ b/components/grid-visualizer/src/data/account-types.ts
@@ -260,6 +260,16 @@ export const accountTypeSpecs: Record<string, AccountTypeSpec> = {
     ],
     beneficiaryRequired: false,
   },
+  SWIFT_ACCOUNT: {
+    accountType: 'SWIFT_ACCOUNT',
+    fields: [
+      { name: 'swiftCode', example: 'DEUTDEFF' },
+      { name: 'bankName', example: 'Deutsche Bank' },
+      { name: 'country', example: 'NG', description: 'ISO 3166-1 alpha-2 code' },
+      { name: 'accountNumber', example: '1234567890', description: 'Or use iban for IBAN-only corridors' },
+    ],
+    beneficiaryRequired: true,
+  },
   AED_ACCOUNT: {
     accountType: 'AED_ACCOUNT',
     fields: [
diff --git a/mintlify/platform-overview/core-concepts/account-model.mdx b/mintlify/platform-overview/core-concepts/account-model.mdx
index 35df3735..51f83886 100644
--- a/mintlify/platform-overview/core-concepts/account-model.mdx
+++ b/mintlify/platform-overview/core-concepts/account-model.mdx
@@ -152,6 +152,22 @@ Grid uses two types of accounts: **internal accounts** (Grid-managed balances) a
     }
     ```
   </Tab>
+
+  <Tab title="SWIFT (International Wire)">
+    ```json
+    {
+      "accountType": "SWIFT_ACCOUNT",
+      "swiftCode": "DEUTDEFF",
+      "bankName": "Deutsche Bank",
+      "country": "DE",
+      "accountNumber": "1234567890",
+      "beneficiary": {
+        "beneficiaryType": "INDIVIDUAL",
+        "fullName": "Hans Schmidt"
+      }
+    }
+    ```
+  </Tab>
 </Tabs>
 
 ### Creating External Accounts
diff --git a/mintlify/snippets/external-accounts.mdx b/mintlify/snippets/external-accounts.mdx
index 4e9fb957..b448381f 100644
--- a/mintlify/snippets/external-accounts.mdx
+++ b/mintlify/snippets/external-accounts.mdx
@@ -327,6 +327,78 @@ curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-acco
 
 </Tab>
 
+<Tab title="SWIFT">
+**International Wire Transfer**
+
+SWIFT accounts support international wire transfers to any country via SWIFT/BIC network.
+
+```bash cURL
+curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \
+  -H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "currency": "USD",
+    "platformAccountId": "swift_wire_001",
+    "accountInfo": {
+      "accountType": "SWIFT_ACCOUNT",
+      "swiftCode": "DEUTDEFF",
+      "bankName": "Deutsche Bank",
+      "country": "DE",
+      "accountNumber": "1234567890",
+      "beneficiary": {
+        "beneficiaryType": "INDIVIDUAL",
+        "fullName": "Hans Schmidt",
+        "birthDate": "1982-11-08",
+        "nationality": "DE",
+        "address": {
+          "line1": "Hauptstraße 789",
+          "city": "Berlin",
+          "postalCode": "10115",
+          "country": "DE"
+        }
+      }
+    }
+  }'
+```
+
+**Using IBAN instead of account number:**
+
+For IBAN-only corridors (e.g., Brazil, UK), use `iban` instead of `accountNumber`:
+
+```bash cURL
+curl -X POST 'https://api.lightspark.com/grid/2025-10-13/customers/external-accounts' \
+  -H 'Authorization: Basic $GRID_CLIENT_ID:$GRID_CLIENT_SECRET' \
+  -H 'Content-Type: application/json' \
+  -d '{
+    "currency": "GBP",
+    "platformAccountId": "swift_iban_001",
+    "accountInfo": {
+      "accountType": "SWIFT_ACCOUNT",
+      "swiftCode": "NWBKGB2L",
+      "bankName": "NatWest Bank",
+      "country": "GB",
+      "iban": "GB29NWBK60161331926819",
+      "beneficiary": {
+        "beneficiaryType": "INDIVIDUAL",
+        "fullName": "James Wilson",
+        "birthDate": "1985-09-03",
+        "nationality": "GB",
+        "address": {
+          "line1": "10 Downing Street",
+          "city": "London",
+          "postalCode": "SW1A 2AA",
+          "country": "GB"
+        }
+      }
+    }
+  }'
+```
+
+<Note>
+  SWIFT code (BIC) must be 8 or 11 characters. Use `accountNumber` for most corridors; use `iban` for IBAN-only corridors (BR, GB). The `country` field is the ISO 3166-1 alpha-2 code of the bank.
+</Note>
+</Tab>
+
 <Tab title="Philippines">
 **PHP Bank Transfer**