v1

latestOpenAPI 3.0.02026-07-2412592575.3 KB
transactions

Retrieve all transactions for a user - does not include data-enriched transaction properties

Requires transactions:read:all or transactions_unenriched:read:all scope. Transactions usually start around the account opening date however in most cases we only retrive the last 12 months before the connection was created. The Opening Date is available at the /accounts endpoint.

get/transactions/unenriched

Query parameters

idsstring[]

Filter on the transaction's Ids (maximum allowed 50)

limitinteger

The total number of records to retrieve

offsetinteger

The offset at which to start retrieving records

startDatestring date

The earliest date to receive transactions from (inclusive)

endDatestring date

The latest date to receive transactions from (inclusive)

startDateModifiedstring date

The earliest date the transactions were modified (inclusive)

endDateModifiedstring date

The latest date the transactions were modified (inclusive)

textstring

The text to filter transactions descriptions by

accountIdstring

The account id to filter transactions by

accountIdsstring[]

The account ids to filter transactions by

creditDebitIndicatorstring

Filter transactions depending on whether they are credit or debit transactions

onlyCountboolean

Ensures ONLY the count of transactions is returned in the meta object

Response

Successful Transactions Response

metaobject

Example response

{
  "data": [
    {
      "accountId": "c390a94f-2309-4cdf-8d02-b0c5304d9f66",
      "amount": {
        "value": -2323,
        "majorUnits": 23,
        "minorUnits": 23,
        "currency": "GBP"
      },
      "date": "2018-07-10T12:00:00.000Z",
      "dateModified": "2018-07-10T11:39:46.506Z",
      "dateCreated": "2018-07-10T11:39:46.506Z",
      "valueDate": "2018-07-10T11:39:46.506Z",
      "id": "c390a94f-3824-4cdf-8d02-b0c5304d9f66",
      "longDescription": "Card Purchase SAINSBURYS S/MKTS  BCC",
      "providerId": "139ccc24c1",
      "status": "posted",
      "transactionCode": {
        "code": "BAC"
      },
      "proprietaryTransactionCode": {
        "code": "BAC"
      },
      "balance": {
        "value": -2323,
        "majorUnits": 23,
        "minorUnits": 23,
        "currency": "GBP"
      },
      "balanceType": "Information",
      "statementReference": "Merchant Name Unique Reference",
      "merchantName": "Merchant Name",
      "merchantCategoryCode": "50C",
      "cardInstrument": {
        "name": "Mrs J Bloggs",
        "pan": "xxxxxxxxxxxx4321",
        "cardSchemeName": "VISA",
        "authorisationType": "Contactless"
      },
      "transactionReference": "Ref 123",
      "transactionInformation": "Cash from Aubrey"
    }
  ]
}