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-31The 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=10Sample 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:
No request body.
curl -X 'GET' \
'https://card-api.sandbox.tuumplatform.com/api/v2/transactions-and-authorisations/search?transactionDateRangeStartDate=2025-05-01&transactionDateRangeEndDate=2025-05-31&statusCode=C&pageNumber=1&pageSize=10' \
-H 'accept: */*' \
-H 'x-tenant-code: MB' \
-H 'Accept-Language: en' \
-H 'x-auth-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjc3JmVG9rZW4iOiI0MzQ0MjQyMzk3IiwiZXhwaXJ5RFRpbWUiOiIyMDI1LTA3LTE0VDEzOjMyOjQ4Iiwicm9sZXMiOlsiQURNSU4iXSwibmFtZSI6Ik1lcmlrZSBEYW5lbHNvbiIsImVtcGxveWVlSWQiOiJJRC0xMjQ3IiwidGVuYW50Q29kZSI6Ik1CIiwiZXhwIjoxNzUyNDk5OTY4fQ.amVGM_Z6spu2dr-Xsnc4RP-TxHk1Zzg0iQIhax5nrC8'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.
Last updated
Was this helpful?