Account Information API

You can easily test the APIs in the Ecster Sandbox https://openbanking.sandbox.ecster.com by using the certificate EcsterSandbox.TPP27_cert.pfx (password: secret)

Use our test persona who's National ID is 'SE430818-9440'.  She has one account with 6 transactions, all of which are dated 2020-01-28.

Account Information API

Get Accounts

 

GET /v1/accounts

Headers
X-ECSTER-consent-id{{consentId}}

 

Response

accounts [0-*] :

  • accountNumber(String): account number
  • reference(String): account reference
  • product
    • id(String): id of product
    • name(String): name of product
  • status(String): "ACTIVE", "TERMINATED"
  • limit(int): approved limit on account in cents
  • used(int): used limit on account in cents
JSON example
{
    "accounts": [
        {
            "accountNumber""9852859536039808",
            "reference""CHwNc38BDlRXD3QBSnNlSwRWNzdGVyLVNIQgxxxxx",
            "product": {
                "id""MCARD001",
                "name""MULTICARD MASTERCARD"
            },
            "status""ACTIVE",
            "limit"1700000,
            "used"1550000
        }
    ]
}

 

Get account

 

GET /v1/accounts/{{reference}}

Headers
X-ECSTER-consent-id{{consentId}}

 

Request
  • <reference> (String) [1] : account reference
Response
  • accountNumber(String): account number
  • product
    • id(String): id of product
    • name(String): name of product
  • status(String): "ACTIVE", "TERMINATED"
  • limit(int): approved limit on account in cents
  • used(int): used limit on account in cents
JSON example
{
    "accountNumber""9852859536039808",
    "product": {
        "id""MCARD001",
        "name""MULTICARD MASTERCARD"
    },
    "status""ACTIVE",
    "limit"1700000,
    "used"1550000
}

Get account transactions

 

GET /v1/accounts/{{reference}}/transactions?from=<fromDate>&to=<toDate>

Headers
X-ECSTER-consent-id{{consentId}}

 

Request
  • <reference> (String) [1] : account reference
  • <fromDate> (Date) [0-1]: YYYY-MM-DD fetch transactions from this date (if not sent fromDate is set to todays date minus 3 months)
  • <toDate> (Date) [0-1]: YYYY-MM-DD fetch transactions to this date (if not sent toDate is set to todays date)
Response

transactions [0-*] :

  • id (String) [1]: an identifier that uniquely identifies the transaction
  • date(Date) [1]: date when transaction occurred
  • description(String): description of transaction
  • amount(int)[1]: transaction amount in cents
  • currency(String): ex. "SEK"
  • foreign [0-1]:
    • amount (Amount) [1]: amount in foreign currency in cents
    • currency (String) [1]: foreign currency
    • exchangeRate (double) [1]: exchange rate between currencies at transaction time
  • type(String): "DEBIT", "CREDIT", "RESERVED_AMOUNT"
JSON example
{
    "transactions": [
        {
            "id""ACSX_1956800274_1435008090",
            "date""2020-01-28T13:54:04+01:00",
            "description""TEST HANDELSBANKEN",
            "amount"50000,
            "currency""SEK",
            "type""DEBIT"
        },
        {
            "id""ACSX_1716118228_394540276",
            "date""2020-01-28T13:54:38+01:00",
            "description""TEST HANDELSBANKEN",
            "amount"100000,
            "currency""SEK",
            "type""DEBIT"
        },
        {
            "id""ACSX_2007944557_814816897",
            "date""2020-01-28T13:54:44+01:00",
            "description""TEST HANDELSBANKEN",
            "amount"200000,
            "currency""SEK",
            "foreign": {
                "amount"23484,
                "currency""USD",
                "exchangeRate"852
            },
            "type""DEBIT"
        },
        {
            "id""ACSX_1776405562_797961953",
            "date""2020-01-28T13:54:51+01:00",
            "description""TEST HANDELSBANKEN",
            "amount"300000,
            "currency""SEK",
            "type""DEBIT"
        },
        {
            "id""ACSX_651332047_206840303",
            "date""2020-01-28T13:54:57+01:00",
            "description""TEST HANDELSBANKEN",
            "amount"400000,
            "currency""SEK",
            "type""DEBIT"
        },
        {
            "id""ACSX_934931316_1852861035",
            "date""2020-01-28T13:55:01+01:00",
            "description""TEST HANDELSBANKEN",
            "amount"500000,
            "currency""SEK",
            "type""DEBIT"
        }
    ]
}

 

Request test account