GET /accounts/{AccountId}/transactions

  • Live
  • 3.1.4

Usage

GET /accounts/{AccountId}/transactions

Description

To fetch a list of transactions for a specific account, you can use this API. You will need to ensure you call the GET /accounts API prior to retrieve the account IDs for the authorised accounts.

For current accounts, you can request 15 months' worth of transactions from the date of the request. For credit cards, we will return transaction data up to 90 days.

We are currently experiencing three issues:

For Credit Cards: We are currently experiencing an issue in which if a date range for credit card transaction data is requested, then the member's most recent actions will not be returned - this is planned to fixed in Q2 2020. It is possible for TPPs to retrieve these transactions by either: requesting credit card transactions by not supplying a date range which we will return the current transactions made since the last statement, or by sending a second request of up to 90 days of transactions by supplying a date range which will return transactions up to the last statement. Both of these responses will provide up to 90 days of credit card transactions.

For Current Accounts: Due to a system limit, if a member has a large number of transactions on their account an error will be returned, rather than returning the members' transactions. There is a work around for Third Parties, who will have to request the same data in smaller date ranges to avoid returning an error.

For Current Accounts: Due to how we translate the date range you may receive a 500 error when requesting 15 months of transaction data. This is likely to occur when requests are made late evening or on weekends.As a work around please retry your request with +/- 1 day in the date range.

As part of our SCA exemption you are allowed enduring access up to 90 days worth of transactions via a single authentication, access to all account information and 15 months transactions during an initial authorisation session however all subsequent requests for account information other balances and transactions, or for data more than 90 days old, will require a reauthentication. If you wish to test this in our Sandbox,  you can simulate calling up to 90 days worth of transactions data up to 1st May 2019. To simulate an API call for older than 90 days old transactions, you will need to request data from 30th April or older.

Below, you can find our implementation and returned optional fields for version 3.1.4 of this API.

Request

Request
As per OBIE specification
We will return transaction data for up to 15 months prior to the date of an account information data request for current accounts.
We will return transaction data from the date of the last statement for a credit card account information data request.
From September 2019 where data older than 90 days is requested this will need to be accompanied be an additional authentication to meet Strong Customer Authentication (SCA) regulatory requirements (PSD2 RTS Article 10)
Nationwide are not currently supporting the splitting up of response messages into pages, pagination. We currently support the sharing of a file size up to a maximum of 10MB as a response message. If, in rare circumstances, you receive an exception message after requesting a large set of data, you can look to request the data for a series of narrower date ranges.

Response

Response Data Block Optional Data Fields NBS Implementation
/Data/Transaction <Transaction> Block Returned
TransactionId Returned
TransactionReference Not Returned
Statement Reference Not Returned
ValueDateTime Returned
TransactionInformation Returned
AddressLine Returned
/Data/Transaction/ChargeAmount <ChargeAmount> Block Not Returned
/Data/Transaction/CurrencyExchange <CurrencyExchange> Block Returned
TargetCurrency Returned
UnitCurrency Not Returned
ContractIdentification Not Returned
QuotationDate Not Returned
/Data/Transaction/CurrencyExchange/InstructedAmount <Instructed Amount> Block Returned
/Data/Transaction/BankTransactionSubCode <BankTransactionCode> Block Not Returned
/Data/Transaction/ProprietaryBankTransactionCode <ProprietaryBankTransactionCode> Block Returned
Issuer Not Returned
/Data/Transaction/Balance <Balance> Block Returned
/Data/Transaction/MerchantDetails <MerchantDetails> Block Returned
MerchantName Returned
MerchantCategoryCode Not Returned
/Data/Transaction/CreditorAgent <CreditorAgent> Block Not Returned
SchemeName Not Returned
Identification Not Returned
Name Not Returned
/Data/Transaction/DebtorAgent <DebtorAgent> Block Not Returned
SchemeName Not Returned
Identification Not Returned
Name Not Returned
/Data/Transaction/DebtorAgent/PostalAddress <PostalAddress> Block Not Returned
/Data/Transaction/DebtorAccount <DebtorAccount> Block Not Returned
SchemeName Not Returned
Identification Not Returned
Name Not Returned
SecondaryIdentification Not Returned
/Data/Transaction/CardInstrument <CardInstrument> Block Returned
AuthorisationType Returned
Name Not Returned
Identification Not Returned

API Reference

/accounts/{AccountId}/transactions
get /accounts/{AccountId}/transactions
Get Transactions

Resource URL

https://api-internal.obtpp.nationwideinterfaces.io/open-banking/v3.1/aisp /accounts/{AccountId}/transactions

Header Parameters

Content-Type

x-fapi-auth-date

The time when the PSU last logged in with the TPP. All dates in the HTTP headers are represented as RFC 7231 Full Dates. An example is below: Sun, 10 Sep 2017 19:43:31 UTC

x-fapi-customer-ip-address

The PSU's IP address if the PSU is currently logged in with the TPP.

x-fapi-interaction-id

An RFC4122 UID used as a correlation id.

Authorization
(required)

An Authorisation Token as per https://tools.ietf.org/html/rfc6750

x-customer-user-agent

Indicates the user-agent that the PSU is using.

Request Body

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Resource Summary

Security

Category

Transactions

Response Error Details
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not found
  • 405 Method Not Allowed
  • 406 Not Acceptable
  • 429 Too Many Requests
  • 500 Internal Server Error

Working...

API Personas

Sam Jones
  • Retail
  • Lives alone
  • Is overdrawn
View Persona
Patrick Nadwarna
  • Retail
  • No regular payments
  • Large balance
View Persona
Cathy Powell
  • Retail
  • Fraud victim
  • Restricted account
View Persona
Josh Chambers
  • Retail
  • Economics student
  • Uses different payment channels
View Persona
Maz Patel
  • Retail
  • Full-time mum
  • Frequent spender
View Persona
Darren Nowak
  • Retail
  • Rarely at home
  • Financially savvy
View Persona
Janet Simpson
  • Retail
  • Closing current account
  • Insufficient funds
View Persona
Melanie Rossi
  • Retail
  • Travels a lot
  • Locked current account
View Persona
Hattie Walker
  • Retail
  • Credit card account
  • Frequent credit card use
View Persona
Victor Braganza
  • Retail
  • Credit card account
  • Inactive account
View Persona
Alex Baker
  • Retail
  • Credit card account
  • Restricted account
View Persona
Martin Hanger
  • Retail
  • Buying new house
  • Evaluating affordability
View Persona
Keesha Mclintock
  • Retail
  • Credit card account
  • Applying for a mortgage
View Persona
Jason Costello
  • Business
  • J C Plumbing
  • New business
View Persona
Jozef Ivan
  • Business
  • The Cake Cave
  • New business
View Persona
Brian McKay
  • Business
  • Johnson's Fish & Chip
  • Money Laundering- Fraud
View Persona
Lee Waterman
  • Business
  • L W Car Parts
  • Lots of payments
View Persona
Muhammed Patel
  • Business
  • Snips
  • Shrinking business
View Persona
Sharon Snow
  • Business
  • Endeavour Web Designs
  • Established, highly successful
View Persona
Lucy Baines
  • Business
  • The Royal Oak
  • Moving business account
View Persona
Roland Hanbury
  • Business
  • Grey Fox Marketing
  • Working abroad
View Persona