Read Account Transactions

Retrieve the transaction list for a specific payment account using the PSD2 Account Information Service API.

Endpoint

GET /v1/accounts/{accountNumber}/transactions{?dateFrom,dateTo,bookingStatus}

Description

Returns the transactions for a single payment account identified by accountNumber.

You must have a valid consent and OAuth2 access token for the account. The accountNumber is obtained from the Read Account List endpoint.

Request

Path Parameters

Parameter	Type	Description
`accountNumber`	String	The unique account number, retrieved from the Read Account List response.

Query Parameters

Parameter	Type	Required	Description
`dateFrom`	ISODate	Conditional	Starting date of the transaction list, required if no delta access is needed.
`dateTo`	ISODate	Optional	End date of the transaction list, defaults to "now" if not provided.
`bookingStatus`	String	Mandatory	Permitted values: `booked`, `pending`, `both`.

Headers

Header	Type	Required	Description
`X-Request-ID`	UUID	Mandatory	Unique identifier for this request, generated by the TPP.
`Consent-ID`	UUID	Mandatory	The consent ID from the related AIS consent authorization.
`Authorization`	String	Mandatory	OAuth2 Bearer token obtained from the SCA process. Format: `Bearer {token}`
`API-Key`	String	Mandatory	Your consumer key from the Developer Portal.
`PSU-IP-Address`	String	Optional	The IP address of the user's device (forwarded from PSU to TPP).
`PSU-IP-Port`	String	Optional	The IP port of the user's device connection (if available).
`PSU-Device-ID`	UUID	Optional	Unique identifier for the user's device or device-specific app installation.
`PSU-Geo-Location`	String	Optional	Geographic location of the user's device (if available).

Request Body

No request body is required for this endpoint.

Response

Success Response

Status Code: 200 OK

Response Headers

Header	Type	Description
`X-Request-ID`	UUID	Echo of the request ID from the original request.

Response Body

Field	Type	Description
`transactions`	Array of Objects	A list of payments for this particular account.
`pagination`	Object	Information about the pagination of the results.

Code Examples

curl -X GET \
https://mp-psd2-api.mypos.com/v1/accounts/50044620073/transactions \
-H 'API-Key: aGDmxHAmpMWUL1txqCsjEcOS' \
-H 'Authorization: Bearer oqeeWzoYfqkf1RsfyaB3hyNiLvY7GNAV6Kta7sGa9X' \
-H 'X-Request-ID: a552babc-7081-44e7-9361-61eb17e0bfd9' \
-H 'Consent-ID: 3c7816ee-3d51-4bf5-8ced-ece2af35d431'

Response Example

{
    "transactions": [
        {
            "paymentReference": "MTIPR0319046QBNA",
            "operation": "Intra-Customer Money Transfer",
            "operationType": "Balance transfer",
            "transactionCurrency": "PLN",
            "transactionAmount": 4.2,
            "originalCurrency": "EUR",
            "originalAmount": 1.0,
            "date": "2019-02-15T14:29:05",
            "sign": "C"
        }
    ],
    "pagination": {
        "pageSize": 1,
        "page": 1,
        "total": 1
    }
}