Get bank details

Download a PDF of your bank details.

Prerequisites

1. The account's accountId, found on your Dashboard > Accounts page.
2. The account must have been created after 16 November 2023. If you'd like to get bank details for an older account, please skip to the guide for older accounts.

API guide

1. Call the account query.
2. Enter the accountId.
3. Add bankDetails.

Query

🔎 Open the query in API Explorer

query getBankDetails {
  account(accountId: "$YOUR_ACCOUNT_ID") {
    bankDetails
  }
}

Response

1. The response includes the download URL (line 4), which begins with bank-details.swan.io.
2. Paste the URL into your browser, then press enter. This triggers the download of your PDF.

{
  "data": {
    "account": {
      "bankDetails": "$DOWNLOAD_URL",
    }
  }
}

Null response

If the API returns a null response, the account was probably created before this feature was introduced. Follow the guide for older accounts instead.

Guide for older accounts

If you'd like to get a bank details PDF for an older account, you have two options.

Actors	Explanation
You with the API	Call the updateAccount mutation with the accountId. "Change" the account language to the account's current language. This triggers the API to generate the PDF, even though the language doesn't change.
Your end user with Web Banking	If you use Swan's Web Banking interface, your users can trigger the generation of their bank details PDF. Go to Web Banking > Account > Settings. Click Save without changing anything, which triggers the API. After a few minutes, the bank details PDF is available on Account > Main IBAN.