This is a preview version of the API intended for early testing and integration. Preview versions are not stable and may include breaking changes before general availability.

General Savings Account Fixed Period

A general savings account with a fixed binding period

accountHolderNamestring

Name of the account holder

accountNamestring

Name of the account

accountNumberstring

The account number assigned by the source financial institution. This is the most stable identifier for the account over time and across collections, and is suitable for matching the same account between repeated collections. Note that stability is best-effort and depends on what the institution exposes; it may occasionally change if the institution restructures or reissues the account, and the value may be masked or partially redacted (e.g., as a masked PAN for credit cards), which can cause collisions between accounts sharing the same visible digits.

bicstring

Bank Identifier Code

bindingPeriodBindingPeriod

Binding period information for this fixed-period account

canDepositboolean

Indicates if the account accepts incoming deposits (true = deposits allowed, false = deposits not permitted)

canWithdrawboolean

Indicates if the account allows outgoing withdrawals (true = withdrawals allowed, false = withdrawals not permitted)

companystring

Company where the financial product has been collected from. Examples: se-folksam, se-lansforsakringar, se-avanza, se-movestic, se-spp, se-nordea, se-amf, se-seb, se-alecta, se-nordnet, se-handelsbanken, se-futur, se-swedbank, se-skandia, se-ica-bank, se-danske-bank.

companyDisplayNamestring

Display name of the company for user-friendly presentation.

currentValueMonetaryAmount

Current value of the account

depositDeposit

Regular deposit information

depositGuaranteeboolean

Whether the account has deposit guarantee protection

hasExclusiveOwnershipboolean

Whether the account holder has exclusive ownership

ibanstring

International Bank Account Number

idstring

Insurely-generated unique identifier for this collection of the financial product. Randomly generated and not stable across collections — a new id is issued each time the product is collected, even for the same underlying account. Use this only as a handle within a single collection (e.g., to correlate holdings and transactions). Do not use it to recognize the same product over time; use the stable institution-assigned identifier on this product (e.g., productNumber, accountNumber, or loanId) for that.

interestGeneralSavingsInterest

Interest information for the account

personalInformationPersonalInformation

Personal information about the person who initiated the data collection.

transactionsLast12MonthsArray<Transaction>

Transaction history for the last 12 months

typestring

Type of the financial product.

Possible Enum values are KF, ISK, CUSTODY_ACCOUNT, UNKNOWN_INVESTMENT_TYPE, IPS_PENSION, PRIVATE_PENSION, OCCUPATIONAL_PENSION, COLLECTIVE_OCCUPATIONAL_PENSION, UNKNOWN_PENSION_TYPE, MORTGAGE_LOAN, UNSECURED_LOAN, GENERAL_SAVINGS_ACCOUNT, GENERAL_SAVINGS_ACCOUNT_FIXED_PERIOD, PSD2_SAVINGS_ACCOUNT, PSD2_CHECKING_ACCOUNT or PSD2_CREDIT_CARD.

withdrawalConditionsWithdrawalConditions

Withdrawal conditions and restrictions

Example

{
  "accountHolderName": "Jane Doe",
  "accountName": "My Fixed Period Savings",
  "accountNumber": "1234567891",
  "bic": "NDEASESS",
  "bindingPeriod": {
    "autoRenewal": true,
    "cancellationFee": {
      "amount": 500,
      "currency": "SEK"
    },
    "endDate": "2026-01-01",
    "lengthPeriod": {
      "periodLength": 2,
      "periodUnit": "YEAR"
    },
    "startDate": "2024-01-01"
  },
  "canDeposit": true,
  "canWithdraw": false,
  "company": "se-lansforsakringar",
  "companyDisplayName": "Länsförsäkringar",
  "currentValue": {
    "amount": 50000,
    "currency": "SEK"
  },
  "deposit": {
    "amount": {
      "amount": 2000,
      "currency": "SEK"
    },
    "frequency": "MONTHLY"
  },
  "depositGuarantee": true,
  "hasExclusiveOwnership": true,
  "iban": "SE3550000000054910000004",
  "id": "6a7c135e-3a56-44ae-bc53-1d0d5321f552",
  "interest": {
    "accruedInterest": {
      "amount": 1250,
      "currency": "SEK"
    },
    "effectiveRate": 0.035,
    "payoutFrequency": "YEARLY",
    "rate": 0.025,
    "rateConditionRanges": [
      {
        "maxAmount": {
          "amount": 25000,
          "currency": "SEK"
        },
        "minAmount": {
          "amount": 0,
          "currency": "SEK"
        },
        "rate": 0.025
      },
      {
        "maxAmount": {
          "amount": 100000,
          "currency": "SEK"
        },
        "minAmount": {
          "amount": 25000.01,
          "currency": "SEK"
        },
        "rate": 0.035
      },
      {
        "maxAmount": null,
        "minAmount": {
          "amount": 100000.01,
          "currency": "SEK"
        },
        "rate": 0.04
      }
    ]
  },
  "personalInformation": {
    "personalNumber": "19010106-1234"
  },
  "transactionsLast12Months": [
    {
      "amount": {
        "amount": 2000,
        "currency": "SEK"
      },
      "description": "Monthly deposit",
      "settlementDate": "2024-01-01",
      "type": "DEPOSIT"
    }
  ],
  "type": "GENERAL_SAVINGS_ACCOUNT_FIXED_PERIOD",
  "withdrawalConditions": {
    "allowedWithdrawals": 1,
    "allowedWithdrawalsPeriod": {
      "periodLength": 1,
      "periodUnit": "YEAR"
    },
    "amountLimit": {
      "amount": 5000,
      "currency": "SEK"
    },
    "fee": {
      "amount": 100,
      "currency": "SEK"
    },
    "waitingPeriod": {
      "periodLength": 7,
      "periodUnit": "DAY"
    }
  }
}

{  "accountHolderName": "Jane Doe",  "accountName": "My Fixed Period Savings",  "accountNumber": "1234567891",  "bic": "NDEASESS",  "bindingPeriod": {    "autoRenewal": true,    "cancellationFee": {      "amount": 500,      "currency": "SEK"    },    "endDate": "2026-01-01",    "lengthPeriod": {      "periodLength": 2,      "periodUnit": "YEAR"    },    "startDate": "2024-01-01"  },  "canDeposit": true,  "canWithdraw": false,  "company": "se-lansforsakringar",  "companyDisplayName": "Länsförsäkringar",  "currentValue": {    "amount": 50000,    "currency": "SEK"  },  "deposit": {    "amount": {      "amount": 2000,      "currency": "SEK"    },    "frequency": "MONTHLY"  },  "depositGuarantee": true,  "hasExclusiveOwnership": true,  "iban": "SE3550000000054910000004",  "id": "6a7c135e-3a56-44ae-bc53-1d0d5321f552",  "interest": {    "accruedInterest": {      "amount": 1250,      "currency": "SEK"    },    "effectiveRate": 0.035,    "payoutFrequency": "YEARLY",    "rate": 0.025,    "rateConditionRanges": [      {        "maxAmount": {          "amount": 25000,          "currency": "SEK"        },        "minAmount": {          "amount": 0,          "currency": "SEK"        },        "rate": 0.025      },      {        "maxAmount": {          "amount": 100000,          "currency": "SEK"        },        "minAmount": {          "amount": 25000.01,          "currency": "SEK"        },        "rate": 0.035      },      {        "maxAmount": null,        "minAmount": {          "amount": 100000.01,          "currency": "SEK"        },        "rate": 0.04      }    ]  },  "personalInformation": {    "personalNumber": "19010106-1234"  },  "transactionsLast12Months": [    {      "amount": {        "amount": 2000,        "currency": "SEK"      },      "description": "Monthly deposit",      "settlementDate": "2024-01-01",      "type": "DEPOSIT"    }  ],  "type": "GENERAL_SAVINGS_ACCOUNT_FIXED_PERIOD",  "withdrawalConditions": {    "allowedWithdrawals": 1,    "allowedWithdrawalsPeriod": {      "periodLength": 1,      "periodUnit": "YEAR"    },    "amountLimit": {      "amount": 5000,      "currency": "SEK"    },    "fee": {      "amount": 100,      "currency": "SEK"    },    "waitingPeriod": {      "periodLength": 7,      "periodUnit": "DAY"    }  }}