Account Data_get-transactions-account-balance_Response_200

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/trustly/main/json-schema/trustly-account-data-get-transactions-account-balance-response-200-schema.json",
  "title": "Account Data_get-transactions-account-balance_Response_200",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trustly-account-data-api-openapi.yml#/components/schemas/Account_Data_get-transactions-account-balance_Response_200",
  "type": "object",
  "properties": {
    "accountBalance": {
      "$ref": "#/$defs/TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalance"
    }
  },
  "required": [
    "accountBalance"
  ],
  "$defs": {
    "Address-3": {
      "type": "object",
      "properties": {
        "address1": {
          "type": "string",
          "minLength": 1,
          "description": "Address Line 1."
        },
        "city": {
          "type": "string",
          "minLength": 1,
          "description": "Address City."
        },
        "state": {
          "type": "string",
          "minLength": 1,
          "description": "2 character ISO State code."
        },
        "zip": {
          "type": "string",
          "minLength": 1,
          "description": "5 character US Zip Code."
        },
        "country": {
          "$ref": "#/$defs/Address3Country",
          "description": "2 character ISO Country code. Currently only the US is supported."
        },
        "address2": {
          "type": "string",
          "description": "Address Line 2."
        }
      },
      "required": [
        "country"
      ],
      "title": "Address-3"
    },
    "Address3Country": {
      "type": "string",
      "enum": [
        "US"
      ],
      "description": "2 character ISO Country code. Currently only the US is supported.",
      "title": "Address3Country"
    },
    "FinancialInstitutionAccountVerification": {
      "type": "object",
      "properties": {
        "verified": {
          "type": "boolean",
          "description": "true if the account is verified; false otherwise."
        },
        "type": {
          "$ref": "#/$defs/FinancialInstitutionAccountVerificationType",
          "description": "Verification Type:\n * `1`: Manual - The account was verified with manual account verification. For example, Manual Electronic Check and Micro Challenge Deposit.\n * `2`: Online Banking verification\t- The Account was verified using the Trustly Online Banking application.\n * `3`: Database verification\t- The Account was verified using the Trustly database or a Third-Party Service.  \n"
        },
        "hasEnoughFunds": {
          "type": "boolean",
          "description": "If true, there is enough balance in account."
        },
        "verificationDate": {
          "type": "integer",
          "description": "The date and time the verification was completed \n as a UNIX timestamp."
        },
        "score": {
          "$ref": "#/$defs/FinancialInstitutionAccountVerificationScore",
          "description": "Verification Score:\n * `0`: Invalid input. The account or routing number are invalid. (Verified Mapping = false)\n * `1`: There is a strong indication that the account is invalid. (Verified Mapping = false)\n * `2`: There are active non-bankable returns on this account that are less than 3 years old. (Verified Mapping = false)\n * `3`: There are administrative returns on this account. (Verified Mapping = false)\n * `4`: The format appears to be suspicious. (Verified Mapping = false)\n * `5`: There is no data on this account or format. (Verified Mapping = false)\n * `6`: We have not seen this account, but the format appears to be valid. (Verified Mapping = true)\n * `7`: We have seen this account but have not received a final disposition on the transaction. (Verified Mapping = true)\n * `8`: We have seen this account, but not in the last 6 months, and have seen no returns associated with the account. (Verified Mapping = true)\n * `9`: We have seen this account in the last 6 months and have seen no returns associated with the account. (Verified Mapping = true)\n * `10`: This account has been directly validated with/by the financial institution or 3rd party. We have the highest confidence that this account is valid. (Verified Mapping = true)\n"
        },
        "thirdPartyScore": {
          "$ref": "#/$defs/FinancialInstitutionAccountVerificationThirdPartyScore",
          "description": "Verification Third-Party Score:\n * `0`: Failed RT validation. (Verified Mapping = 0)\n * `100`: The supplier has a strong indication that this account is invalid. (Verified Mapping = 1)\n * `200`: The supplier has active non-bankable debt(s) on this account that are less than 3 years old. (Verified Mapping = 2)\n * `300`: The supplier has administrative returns on this account. (Verified Mapping = 3)\n * `400`: The supplier does not have Neg data on this account, but the format appears to be suspicious. (Verified Mapping = 4)\n * `500`: The supplier does not have data on this account or format. (Verified Mapping = 5)\n * `600`: The supplier has not seen this account, but the format appears valid. (Verified Mapping = 6)\n * `700`: The supplier has seen this account, but did not receive a final disposition on the transaction. (Verified Mapping = 7)\n * `800`: The supplier has seen this account, but not in the last 6 months. (Verified Mapping = 8)\n * `900`: The supplier has seen this account in the last 6 months. (Verified Mapping = 9)\n * `999`: The supplier has the highest confidence that this account is valid. (Verified Mapping = 10)\n"
        },
        "numberOfTries": {
          "type": "number",
          "format": "double",
          "description": "Number of tries allowed."
        },
        "numberOfAttemptsLeft": {
          "type": "number",
          "format": "double",
          "description": "Number of remaining attempts."
        }
      },
      "required": [
        "verified",
        "type",
        "hasEnoughFunds",
        "verificationDate"
      ],
      "title": "FinancialInstitutionAccountVerification"
    },
    "FinancialInstitutionAccountVerificationScore": {
      "type": "string",
      "enum": [
        "0",
        "1",
        "2",
        "3",
        "4",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10"
      ],
      "description": "Verification Score:\n * `0`: Invalid input. The account or routing number are invalid. (Verified Mapping = false)\n * `1`: There is a strong indication that the account is invalid. (Verified Mapping = false)\n * `2`: There are active non-bankable returns on this account that are less than 3 years old. (Verified Mapping = false)\n * `3`: There are administrative returns on this account. (Verified Mapping = false)\n * `4`: The format appears to be suspicious. (Verified Mapping = false)\n * `5`: There is no data on this account or format. (Verified Mapping = false)\n * `6`: We have not seen this account, but the format appears to be valid. (Verified Mapping = true)\n * `7`: We have seen this account but have not received a final disposition on the transaction. (Verified Mapping = true)\n * `8`: We have seen this account, but not in the last 6 months, and have seen no returns associated with the account. (Verified Mapping = true)\n * `9`: We have seen this account in the last 6 months and have seen no returns associated with the account. (Verified Mapping = true)\n * `10`: This account has been directly validated with/by the financial institution or 3rd party. We have the highest confidence that this account is valid. (Verified Mapping = true)\n",
      "title": "FinancialInstitutionAccountVerificationScore"
    },
    "FinancialInstitutionAccountVerificationThirdPartyScore": {
      "type": "string",
      "enum": [
        "0",
        "100",
        "200",
        "300",
        "400",
        "500",
        "600",
        "700",
        "800",
        "900",
        "999"
      ],
      "description": "Verification Third-Party Score:\n * `0`: Failed RT validation. (Verified Mapping = 0)\n * `100`: The supplier has a strong indication that this account is invalid. (Verified Mapping = 1)\n * `200`: The supplier has active non-bankable debt(s) on this account that are less than 3 years old. (Verified Mapping = 2)\n * `300`: The supplier has administrative returns on this account. (Verified Mapping = 3)\n * `400`: The supplier does not have Neg data on this account, but the format appears to be suspicious. (Verified Mapping = 4)\n * `500`: The supplier does not have data on this account or format. (Verified Mapping = 5)\n * `600`: The supplier has not seen this account, but the format appears valid. (Verified Mapping = 6)\n * `700`: The supplier has seen this account, but did not receive a final disposition on the transaction. (Verified Mapping = 7)\n * `800`: The supplier has seen this account, but not in the last 6 months. (Verified Mapping = 8)\n * `900`: The supplier has seen this account in the last 6 months. (Verified Mapping = 9)\n * `999`: The supplier has the highest confidence that this account is valid. (Verified Mapping = 10)\n",
      "title": "FinancialInstitutionAccountVerificationThirdPartyScore"
    },
    "FinancialInstitutionAccountVerificationType": {
      "type": "string",
      "enum": [
        "1",
        "2",
        "3"
      ],
      "description": "Verification Type:\n * `1`: Manual - The account was verified with manual account verification. For example, Manual Electronic Check and Micro Challenge Deposit.\n * `2`: Online Banking verification\t- The Account was verified using the Trustly Online Banking application.\n * `3`: Database verification\t- The Account was verified using the Trustly database or a Third-Party Service.  \n",
      "title": "FinancialInstitutionAccountVerificationType"
    },
    "PaymentProvider-2": {
      "type": "object",
      "properties": {
        "paymentProviderId": {
          "type": "string",
          "minLength": 1,
          "description": "A unique identifier for the Payment Provider."
        },
        "type": {
          "type": "number",
          "format": "double"
        },
        "name": {
          "type": "string",
          "minLength": 1,
          "description": "Payment Provider name."
        },
        "instantPayoutAvailable": {
          "type": "boolean",
          "description": "Whether payment provider supports instant payout."
        },
        "subType": {
          "$ref": "#/$defs/PaymentProvider2SubType",
          "description": "Financial Institution Account Type:\n * `1000`: Online Banking\n * `2000`: Manual Entry\n * `2001`: Manual Entry with Challenge Deposit\n"
        },
        "swift": {
          "type": "string"
        },
        "address": {
          "$ref": "#/$defs/Address-3"
        },
        "country": {
          "$ref": "#/$defs/PaymentProvider2Country",
          "description": "2-character ISO code of the country for the bank account that was selected. Currently only the US, CA, UK, DE, and AU are supported."
        },
        "instantPayment": {
          "type": "boolean"
        }
      },
      "required": [
        "paymentProviderId",
        "type",
        "name",
        "instantPayoutAvailable"
      ],
      "title": "PaymentProvider-2"
    },
    "PaymentProvider2Country": {
      "type": "string",
      "enum": [
        "US",
        "CA",
        "UK",
        "DE",
        "AU"
      ],
      "description": "2-character ISO code of the country for the bank account that was selected. Currently only the US, CA, UK, DE, and AU are supported.",
      "title": "PaymentProvider2Country"
    },
    "PaymentProvider2SubType": {
      "type": "string",
      "enum": [
        "1000",
        "2000",
        "2001"
      ],
      "description": "Financial Institution Account Type:\n * `1000`: Online Banking\n * `2000`: Manual Entry\n * `2001`: Manual Entry with Challenge Deposit\n",
      "title": "PaymentProvider2SubType"
    },
    "TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalance": {
      "type": "object",
      "properties": {
        "account": {
          "$ref": "#/$defs/TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalanceAccount"
        },
        "available": {
          "type": "string",
          "minLength": 1,
          "description": "Funds currently available for withdrawal or spending (after pending transactions). Returns a decimal numeric string."
        },
        "currency": {
          "type": "string",
          "minLength": 1
        },
        "amount": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": [
        "account",
        "currency"
      ],
      "title": "TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalance"
    },
    "TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalanceAccount": {
      "type": "object",
      "properties": {
        "providerId": {
          "type": "string",
          "description": "Payment provider ID."
        },
        "paymentProvider": {
          "$ref": "#/$defs/PaymentProvider-2"
        },
        "nameOnAccount": {
          "type": "string",
          "description": "Account owner name."
        },
        "country": {
          "$ref": "#/$defs/TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalanceAccountCountry",
          "description": "2-character ISO code of the country for the bank account that was selected. Currently only the US, CA, UK, DE, and AU are supported."
        },
        "name": {
          "type": "string",
          "description": "A description to identify an specific account (e.g. \"Test checking account\")"
        },
        "type": {
          "type": "number",
          "format": "double",
          "description": "See Financial Institution Account Type Values."
        },
        "profile": {
          "type": "number",
          "format": "double",
          "description": "See Financial Institution Account Profile Values"
        },
        "accountNumber": {
          "type": "string",
          "minLength": 1,
          "description": "Bank Account Number or VAN if `virtualAccountRoutingPair` is equal to `true`."
        },
        "iban": {
          "type": "string",
          "description": "IBAN (International Bank Account Number) is an internationally agreed system of identifying bank accounts across national borders"
        },
        "verified": {
          "type": "boolean",
          "description": "Indicates if the account is verified or not."
        },
        "verification": {
          "$ref": "#/$defs/FinancialInstitutionAccountVerification"
        },
        "source": {
          "type": "number",
          "format": "double"
        },
        "routingNumber": {
          "type": "string",
          "minLength": 1,
          "description": "Bank Routing Number."
        },
        "token": {
          "type": "string",
          "minLength": 1,
          "description": "The Account Token."
        },
        "accountNumberLastFour": {
          "type": "string",
          "description": "The last 4 digits of the real account number."
        },
        "virtualAccountRoutingPair": {
          "type": "boolean",
          "description": "Indicates if account is using virtual/tokenized account and routing numbers (VANs/TANs) or not."
        },
        "taxId": {
          "type": "string",
          "description": "(Only Brazilian Accounts) Personal or business taxpayer identifier."
        }
      },
      "title": "TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalanceAccount"
    },
    "TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalanceAccountCountry": {
      "type": "string",
      "enum": [
        "US",
        "CA",
        "UK",
        "DE",
        "AU"
      ],
      "description": "2-character ISO code of the country for the bank account that was selected. Currently only the US, CA, UK, DE, and AU are supported.",
      "title": "TransactionsTransactionIdPaymentPaymentProviderAccountBalanceGetResponsesContentApplicationJsonSchemaAccountBalanceAccountCountry"
    }
  }
}