Search card network transactions

Here, you will learn how to search card network transactions in Tuum.

Use case

In this example, we will demonstrate how to retrieve a list of clearing transactions that were successfully processed in May 2025.

Use case data	API parameters with values
Searching for card network transactions from May 2025. The date format used is YYYY-MM-DD.	...search?transactionDateRangeStartDate=2025-05-01&transactionDateRangeEndDate=2025-05-31
The processing of clearing transactions is complete. The statusCode is C.	...&statusCode=C...
The request retrieves search results from page 1, with a page size of 10.	...&pageNumber=1&pageSize=10

Sample API call

To retrieve a list of clearing transactions, use the following endpoint:

https://card-api.sandbox.tuumplatform.com/api/v2/transactions-and-authorisations/search

Learn more about the search card transactions and authorisations endpoint in the Tuum developer portal.

Sample request

The sample request body is as follows:

Body

No request body.

cURL

Sample response

Below you will find the response to the API request:

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "values": [
            {
                "transactionId": "C001718025939",
                "messageType": null,
                "transactionTypeCode": "27",
                "accountOwnerPersonId": "ID-1031",
                "cardholderPersonId": "ID-1031",
                "cardNumber": "412345******9546",
                "panReference": "6199179598814983435",
                "cardId": "C001718025116",
                "cardAcceptorNameLocation": null,
                "purchaseCountryCode": "EE",
                "posData": "00",
                "merchantCategoryCode": "6011",
                "merchantName": "ATM00EUR",
                "merchantCity": "Tartu",
                "transactionMoney": {
                    "amount": 25.00,
                    "currencyCode": "EUR"
                },
                "dateLocal": "0513",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-27T06:15:10.403148Z",
                "clearingTransactionReceivedDtime": "2025-05-27T05:46:51.652802Z",
                "authorisationTime": null,
                "actionCode": null,
                "cardMoney": {
                    "amount": 25.00,
                    "currencyCode": "EUR"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXY32021",
                "cardAcceptorId": "10044010 031",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": true,
                "bin": "412345",
                "productScheme": "VISA",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "CASH"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025938",
                "messageType": null,
                "transactionTypeCode": "26",
                "accountOwnerPersonId": "ID-1031",
                "cardholderPersonId": "ID-1031",
                "cardNumber": "412345******9546",
                "panReference": "6199179598814983435",
                "cardId": "C001718025116",
                "cardAcceptorNameLocation": null,
                "purchaseCountryCode": "EE",
                "posData": "00",
                "merchantCategoryCode": "5999",
                "merchantName": "POS00EUR",
                "merchantCity": "Tartu",
                "transactionMoney": {
                    "amount": 17.05,
                    "currencyCode": "EUR"
                },
                "dateLocal": "0513",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-27T06:15:10.242187Z",
                "clearingTransactionReceivedDtime": "2025-05-27T05:46:51.640967Z",
                "authorisationTime": null,
                "actionCode": null,
                "cardMoney": {
                    "amount": 17.05,
                    "currencyCode": "EUR"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXY32021",
                "cardAcceptorId": "10044010 031",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": true,
                "bin": "412345",
                "productScheme": "VISA",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "REFUND"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025937",
                "messageType": null,
                "transactionTypeCode": "25",
                "accountOwnerPersonId": "ID-1031",
                "cardholderPersonId": "ID-1031",
                "cardNumber": "412345******9546",
                "panReference": "6199179598814983435",
                "cardId": "C001718025116",
                "cardAcceptorNameLocation": null,
                "purchaseCountryCode": "EE",
                "posData": "00",
                "merchantCategoryCode": "5999",
                "merchantName": "POS00EUR",
                "merchantCity": "Tartu",
                "transactionMoney": {
                    "amount": 16.05,
                    "currencyCode": "EUR"
                },
                "dateLocal": "0513",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-27T06:15:10.074941Z",
                "clearingTransactionReceivedDtime": "2025-05-27T05:46:51.621474Z",
                "authorisationTime": null,
                "actionCode": null,
                "cardMoney": {
                    "amount": 16.05,
                    "currencyCode": "EUR"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXY32021",
                "cardAcceptorId": "10044010 031",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": true,
                "bin": "412345",
                "productScheme": "VISA",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025934",
                "messageType": null,
                "transactionTypeCode": "25",
                "accountOwnerPersonId": "ID-1031",
                "cardholderPersonId": "ID-1031",
                "cardNumber": "412345******9546",
                "panReference": "6199179598814983435",
                "cardId": "C001718025116",
                "cardAcceptorNameLocation": null,
                "purchaseCountryCode": "EE",
                "posData": "00",
                "merchantCategoryCode": "5999",
                "merchantName": "POS00EUR",
                "merchantCity": "Tartu",
                "transactionMoney": {
                    "amount": 15.05,
                    "currencyCode": "EUR"
                },
                "dateLocal": "0513",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-27T05:42:14.851552Z",
                "clearingTransactionReceivedDtime": "2025-05-27T05:39:25.300075Z",
                "authorisationTime": null,
                "actionCode": null,
                "cardMoney": {
                    "amount": 15.05,
                    "currencyCode": "EUR"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXY32021",
                "cardAcceptorId": "10044010 031",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "SECOND_PRESENTMENT",
                "reversal": true,
                "bin": "412345",
                "productScheme": "VISA",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025933",
                "messageType": null,
                "transactionTypeCode": "25",
                "accountOwnerPersonId": "ID-1031",
                "cardholderPersonId": "ID-1031",
                "cardNumber": "412345******9546",
                "panReference": "6199179598814983435",
                "cardId": "C001718025116",
                "cardAcceptorNameLocation": null,
                "purchaseCountryCode": "EE",
                "posData": "00",
                "merchantCategoryCode": "5999",
                "merchantName": "POS00EUR",
                "merchantCity": "Tartu",
                "transactionMoney": {
                    "amount": 14.05,
                    "currencyCode": "EUR"
                },
                "dateLocal": "0513",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-26T10:15:10.067599Z",
                "clearingTransactionReceivedDtime": "2025-05-26T08:45:44.346988Z",
                "authorisationTime": null,
                "actionCode": null,
                "cardMoney": {
                    "amount": 14.05,
                    "currencyCode": "EUR"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXY32021",
                "cardAcceptorId": "10044010 031",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": true,
                "bin": "412345",
                "productScheme": "VISA",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025929",
                "messageType": "1240",
                "transactionTypeCode": "00",
                "accountOwnerPersonId": "ID-8885",
                "cardholderPersonId": "ID-8885",
                "cardNumber": "111172******3692",
                "panReference": "9781497359887493883",
                "cardId": "C001718040686",
                "cardAcceptorNameLocation": "POS00USD ANOTHER SHOP 14 >TALLINN     EST",
                "purchaseCountryCode": "EST",
                "posData": "000560600140",
                "merchantCategoryCode": "5999",
                "merchantName": null,
                "merchantCity": null,
                "transactionMoney": {
                    "amount": 60.00,
                    "currencyCode": "EUR"
                },
                "dateLocal": "250520081646",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-20T10:15:10.104367Z",
                "clearingTransactionReceivedDtime": "2025-05-20T08:23:02.516696Z",
                "authorisationTime": "2025-05-20T08:16:47.929805Z",
                "actionCode": "000",
                "cardMoney": {
                    "amount": 56.00,
                    "currencyCode": "GBP"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXH20233",
                "cardAcceptorId": "10379733 120",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": false,
                "bin": "111172",
                "productScheme": "MASTERCARD",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "OTHER_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025932",
                "messageType": "1240",
                "transactionTypeCode": "00",
                "accountOwnerPersonId": "ID-8885",
                "cardholderPersonId": "ID-8885",
                "cardNumber": "111172******0058",
                "panReference": "5002226883777123145",
                "cardId": "C001718040687",
                "cardAcceptorNameLocation": "POS00EUR ECOMMERCE SHOP1 >TARTU       EST",
                "purchaseCountryCode": "EST",
                "posData": "600570600140",
                "merchantCategoryCode": "5999",
                "merchantName": null,
                "merchantCity": null,
                "transactionMoney": {
                    "amount": 20.00,
                    "currencyCode": "EUR"
                },
                "dateLocal": "250520084021",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-20T08:41:52.306536Z",
                "clearingTransactionReceivedDtime": "2025-05-20T08:40:34.720906Z",
                "authorisationTime": "2025-05-20T08:40:21.36319Z",
                "actionCode": "000",
                "cardMoney": {
                    "amount": 17.00,
                    "currencyCode": "GBP"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXH20233",
                "cardAcceptorId": "10379733 120",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": false,
                "bin": "111172",
                "productScheme": "MASTERCARD",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "OTHER_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025931",
                "messageType": "1240",
                "transactionTypeCode": "00",
                "accountOwnerPersonId": "ID-8885",
                "cardholderPersonId": "ID-8885",
                "cardNumber": "111172******0058",
                "panReference": "5002226883777123145",
                "cardId": "C001718040687",
                "cardAcceptorNameLocation": "POS00EUR ECOMMERCE SHOP1 >TARTU       EST",
                "purchaseCountryCode": "EST",
                "posData": "600570600140",
                "merchantCategoryCode": "5999",
                "merchantName": null,
                "merchantCity": null,
                "transactionMoney": {
                    "amount": 20.00,
                    "currencyCode": "GBP"
                },
                "dateLocal": "250520083432",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-20T08:36:32.972595Z",
                "clearingTransactionReceivedDtime": "2025-05-20T08:36:07.893519Z",
                "authorisationTime": "2025-05-20T08:34:32.537685Z",
                "actionCode": "000",
                "cardMoney": {
                    "amount": 20.00,
                    "currencyCode": "GBP"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXH20233",
                "cardAcceptorId": "10379733 120",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": false,
                "bin": "111172",
                "productScheme": "MASTERCARD",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025927",
                "messageType": "1240",
                "transactionTypeCode": "00",
                "accountOwnerPersonId": "ID-8885",
                "cardholderPersonId": "ID-8885",
                "cardNumber": "111172******7204",
                "panReference": "2943060319493937249",
                "cardId": "C001718040680",
                "cardAcceptorNameLocation": "POS00EUR ANOTHER SHOP 14 >TALLINN     EST",
                "purchaseCountryCode": "EST",
                "posData": "000560600140",
                "merchantCategoryCode": "5999",
                "merchantName": null,
                "merchantCity": null,
                "transactionMoney": {
                    "amount": 50.00,
                    "currencyCode": "EUR"
                },
                "dateLocal": "250519101042",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-19T10:15:10.637935Z",
                "clearingTransactionReceivedDtime": "2025-05-19T10:14:13.223624Z",
                "authorisationTime": "2025-05-19T10:10:43.656905Z",
                "actionCode": "000",
                "cardMoney": {
                    "amount": 50.00,
                    "currencyCode": "EUR"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXH20233",
                "cardAcceptorId": "10379733 120",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": false,
                "bin": "111172",
                "productScheme": "MASTERCARD",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "CARD_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            },
            {
                "transactionId": "C001718025926",
                "messageType": "1240",
                "transactionTypeCode": "00",
                "accountOwnerPersonId": "ID-8885",
                "cardholderPersonId": "ID-8885",
                "cardNumber": "111172******9700",
                "panReference": "1762379108656115990",
                "cardId": "C001718040674",
                "cardAcceptorNameLocation": "POS00USD ANOTHER SHOP 14 >TALLINN     EST",
                "purchaseCountryCode": "EST",
                "posData": "000560600140",
                "merchantCategoryCode": "5999",
                "merchantName": null,
                "merchantCity": null,
                "transactionMoney": {
                    "amount": 60.00,
                    "currencyCode": "EUR"
                },
                "dateLocal": "250516130830",
                "posDateLocal": null,
                "posTimeLocal": null,
                "clearingTransactionProcessedDtime": "2025-05-19T10:15:10.494997Z",
                "clearingTransactionReceivedDtime": "2025-05-19T10:14:13.215383Z",
                "authorisationTime": "2025-05-16T13:08:30.563011Z",
                "actionCode": "000",
                "cardMoney": {
                    "amount": 56.00,
                    "currencyCode": "GBP"
                },
                "retrievalReferenceNumber": null,
                "cardAcceptorTerminalId": "NXH20233",
                "cardAcceptorId": "10379733 120",
                "transactionState": "C",
                "authorisation": false,
                "messageTypeName": "FIRST_PRESENTMENT",
                "reversal": false,
                "bin": "111172",
                "productScheme": "MASTERCARD",
                "transactionLabels": [
                    "CARD_NOT_PRESENT",
                    "OFF_US",
                    "OTHER_CURRENCY",
                    "PURCHASE"
                ],
                "walletId": null,
                "errorReason": null
            }
        ],
        "pageNumber": 1,
        "pageSize": 10,
        "endReached": false,
        "sort": null
    }
}

Result

The first 10 clearing transactions that match the search criteria are returned.