Read Card Account Transactions

GET /v1/card-accounts/{accountNumber}/transactions

Read card account transactions for a given account by accountNumber.

Path Parameters

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

Query Parameters

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

Request Headers

Parameter	Type	Description
`X-Request-ID`	UUID	Unique request ID, set by the initiating party (TPP). Mandatory.
`Consent-ID`	UUID	The consentId of the related AIS consent. Mandatory.
`Authorization`	String	OAuth2 Bearer token obtained from SCA performed prior to this request. Mandatory.
`API-Key`	String	Consumer key available on the developers portal. Mandatory.
`PSU-IP-Address`	String	Forwarded IP address between PSU and TPP. Optional.
`PSU-IP-Port`	String	Forwarded IP port between PSU and TPP, if available. Optional.
`PSU-Device-ID`	String	UUID for a device or application installation, unaltered until removal. Optional.
`PSU-Geo-Location`	String	Forwarded geo location between PSU and TPP, if available. Optional.

Request Body

No request body.

Response

HTTP 200 OK

Response Headers

Parameter	Type	Description
`X-Request-ID`	UUID	Unique request ID, set by the initiating party (TPP). Mandatory.

Response Body

Parameter	Type	Description
`transactions`	Array of Payment Objects	List of payments for this account. Mandatory.
`pagination`	Pagination	Information about pagination of results. Mandatory.

Example

Request

curl -X GET \
https://mp-psd2-api.mypos.com/v1/card-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

{
    "transactions": [
        {
            "paymentReference": "MTIPS0319046QBMX",
            "operation": "Intra-Customer Money Transfer",
            "operationType": "Balance transfer",
            "transactionCurrency": "EUR",
            "transactionAmount": -1.0,
            "originalCurrency": "EUR",
            "originalAmount": -1.0,
            "date": "2019-02-15T14:28:05",
            "sign": "D"
        },
        {
            "paymentReference": "MTIPS0319046QBMS",
            "operation": "Intra-Customer Money Transfer",
            "operationType": "Balance transfer",
            "transactionCurrency": "EUR",
            "transactionAmount": -1.0,
            "originalCurrency": "EUR",
            "originalAmount": -1.0,
            "date": "2019-02-15T14:27:32",
            "sign": "D"
        }
    ],
    "pagination": {
        "pageSize": 2,
        "page": 1,
        "total": 2
    }
}