List transactions
curl --request GET \
--url https://sandbox-api.cardcore.cloud/institutions/transactions \
--header 'Authorization: Bearer <token>'{
"statusCode": 200,
"message": "Transactions Retrieved Successfully!",
"data": [
{
"_id": "6a14291e64e77fc7a0e2b3af",
"card": {
"_id": "69d4dd694818713f69fec11b",
"institution": "68da3e6080b90fbbb96716c9",
"cardProgram": "68da531880b90fbbb9671b38",
"referenceCode": "SUPRPR65228531775557727619",
"scheme": "Mastercard",
"type": "virtual",
"bin": "0902322423",
"expiryMonth": "05",
"expiryYear": 2029,
"pinEnabled": true,
"seqNumber": "001",
"enroll2FA": true,
"status": "active",
"expiryDate": "2029-05-17T00:00:00.000Z",
"account": {
"currency": "NGN",
"type": "00",
"number": "0117964837",
"bankCode": "999241"
},
"customer": {
"uniqueId": "9992410117964837",
"firstName": "John",
"middleName": "Robert",
"lastName": "Doe",
"emailAddress": "[email protected]",
"phoneNumber": "+2341234567890",
"dateOfBirth": "1990-01-01T00:00:00.000Z",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "Lagos",
"state": "Lagos",
"country": "Nigeria",
"postalCode": "100001"
}
},
"cardHolderId": "sandbox-cardholder-e2a5bbc7-f201-4ef1-af49-e19383a851b9",
"lastFour": "2384",
"pan": "090232fF2384",
"cvv2": "tok_dev_BxiqEUdTyIdy7kqlPWSTKm",
"icvv": "tok_dev_kIULobJIBIF6FRKTOclZgg",
"serviceCode": "601",
"printCard": false,
"token": "sandbox-token-ccfc8c40-9ae6-4577-b6db-47cf3bee84db",
"cvv": "tok_dev_kf9xEpfzCyHphXYcxiKUnv",
"allowDigitization": false,
"embossingName": "Prince Kyemuteh Muteh",
"twoFAEnrolled": false,
"pinAttempts": 0,
"honorific": "",
"gender": "",
"createdAt": "2026-04-07T10:33:13.188Z",
"updatedAt": "2026-05-25T12:38:20.932Z",
"__v": 0,
"hash": "7307208218A127E8E928285CAC663D1B56740F1B",
"secureData": "TQncGYwGLAP9Nb+mMz5rPEqiBUMTw92wBb16ixtKM8hvhuynLqFi+JR4qv1f03UOYPwwOqo/lGKaW7/Hi5xEjl/0+g0GbzXmcamBNDsHytJ1GE97j/T9rwuS9RxoYQZgdCowG+oy22q5P2HTDw4bbw5FWUP4XlbXJ+Al6sf8OzRyeTd+eLF2sdh26Kj6WX+aVc+hv464gpsliNHt8OJ3s5i6wtD5QC5QbmwHzGQkqhpAnlxxStrcyay6BxYsOKQW7Xc3rXBn+8hS2Kx6ln/ynkF2XfzKQbgvsRmer/S0tWJd80zcP09LlkMMZ2OPFG/G9KH72IPr4RKzWSa8GEcPjQ=="
},
"institution": {
"_id": "68da3e6080b90fbbb96716c9",
"name": "Primetech",
"code": "primetech",
"registrationCountry": "Nigeria",
"address": {
"street": "wuse 2",
"city": "Abuja",
"state": "Abuja Federal Capital Territory",
"country": "Nigeria"
},
"emailAddress": "[email protected]",
"phoneNumber": "+2347030338024",
"websiteUrl": "https://primetech.com",
"isApproved": false,
"status": "active",
"isBlocked": false,
"createdBy": "68d56d8080b90fbbb9671426",
"users": [
"68da3e6180b90fbbb96716cb"
],
"memberships": [
"68da3e6180b90fbbb96716cd"
],
"cloudCardWalletId": "EGN8HVCKPO",
"cloudCardClientId": "67c5b11d3b1993f225c3fbab",
"createdAt": "2025-09-29T08:08:00.799Z",
"updatedAt": "2026-04-01T10:36:42.883Z",
"__v": 0
},
"mti": "0200",
"stan": "578820",
"rrn": "842395619435",
"processingCode": "000000",
"terminalId": "TERM0001",
"merchantId": "000000000000001",
"amount": 1000,
"merchantFeeAmount": 0,
"amounts": {
"amount": "000000100000",
"currency": "566"
},
"dates": {
"transmission": "Mon May 25 2026 10:49:02 GMT+0000 (Coordinated Universal Time)",
"local": "Mon May 25 2026 10:49:02 GMT+0000 (Coordinated Universal Time)",
"expiration": "2905"
},
"cardData": {
"pan": "090232fF2384",
"track2": "090232fF2384=2905601000000000000",
"_id": "6a14291e64e77fc7a0e2b3b0"
},
"tppData": null,
"nestedFields": null,
"messageType": "Unknown Message Type",
"correlationId": "578820",
"reversed": false,
"reversalId": "false",
"metadata": null,
"originalMessage": {
"0": "0200",
"2": "090232fF2384",
"3": "000000",
"4": "000000100000",
"7": "0525104902",
"11": "578820",
"12": "104902",
"13": "0525",
"14": "2905",
"22": "051",
"25": "00",
"35": "090232fF2384=2905601000000000000",
"37": "842395619435",
"40": "801",
"41": "TERM0001",
"42": "000000000000001",
"49": "566",
"102": "0117964837",
"123": "000000100000000"
},
"response": {
"39": "96"
},
"additionaldata": null,
"timestamps": {
"jcardToCardCore": {
"timestamp": "2026-05-25T10:49:02.726Z",
"direction": "inbound",
"description": "postbridge to cardcore"
},
"cardCoreToInstitution": {
"timestamp": "2026-05-25T10:49:02.787Z",
"direction": "outbound",
"description": "cardcore to institution"
},
"institutionToCardCore": {
"timestamp": "2026-05-25T10:49:02.806Z",
"direction": "inbound",
"description": "institution to cardcore"
},
"cardCoreToJcard": {
"timestamp": "2026-05-25T10:49:02.810Z",
"direction": "outbound",
"description": "cardcore to postbridge"
}
},
"isDeleted": false,
"transactionType": null,
"transactionAmount": 1000,
"transactionStatus": "failed",
"transactionAccount": null,
"transactionChannel": {
"channelType": "pos",
"detailedChannelType": "pos_chip",
"entryMode": "051",
"posConditionCode": "00",
"serviceCode": "801",
"posDataCode": "000000100000000",
"isCardPresent": true,
"isOnline": false,
"isPhysical": true,
"isAtm": false,
"timestamp": "2026-05-25T10:49:02.775Z"
},
"accounts": {
"account1": "0117964837"
},
"posData": {
"capabilities": "000000100000000"
},
"createdAt": "2026-05-25T10:49:02.729Z",
"updatedAt": "2026-05-25T10:49:02.810Z",
"__v": 0,
"duration": 103,
"responseCode": "96"
}
]
}Institution Transaction
List transactions
List institution transactions with optional pagination and filter parameters.
GET
/
institutions
/
transactions
List transactions
curl --request GET \
--url https://sandbox-api.cardcore.cloud/institutions/transactions \
--header 'Authorization: Bearer <token>'{
"statusCode": 200,
"message": "Transactions Retrieved Successfully!",
"data": [
{
"_id": "6a14291e64e77fc7a0e2b3af",
"card": {
"_id": "69d4dd694818713f69fec11b",
"institution": "68da3e6080b90fbbb96716c9",
"cardProgram": "68da531880b90fbbb9671b38",
"referenceCode": "SUPRPR65228531775557727619",
"scheme": "Mastercard",
"type": "virtual",
"bin": "0902322423",
"expiryMonth": "05",
"expiryYear": 2029,
"pinEnabled": true,
"seqNumber": "001",
"enroll2FA": true,
"status": "active",
"expiryDate": "2029-05-17T00:00:00.000Z",
"account": {
"currency": "NGN",
"type": "00",
"number": "0117964837",
"bankCode": "999241"
},
"customer": {
"uniqueId": "9992410117964837",
"firstName": "John",
"middleName": "Robert",
"lastName": "Doe",
"emailAddress": "[email protected]",
"phoneNumber": "+2341234567890",
"dateOfBirth": "1990-01-01T00:00:00.000Z",
"address": {
"line1": "123 Main Street",
"line2": "Apt 4B",
"city": "Lagos",
"state": "Lagos",
"country": "Nigeria",
"postalCode": "100001"
}
},
"cardHolderId": "sandbox-cardholder-e2a5bbc7-f201-4ef1-af49-e19383a851b9",
"lastFour": "2384",
"pan": "090232fF2384",
"cvv2": "tok_dev_BxiqEUdTyIdy7kqlPWSTKm",
"icvv": "tok_dev_kIULobJIBIF6FRKTOclZgg",
"serviceCode": "601",
"printCard": false,
"token": "sandbox-token-ccfc8c40-9ae6-4577-b6db-47cf3bee84db",
"cvv": "tok_dev_kf9xEpfzCyHphXYcxiKUnv",
"allowDigitization": false,
"embossingName": "Prince Kyemuteh Muteh",
"twoFAEnrolled": false,
"pinAttempts": 0,
"honorific": "",
"gender": "",
"createdAt": "2026-04-07T10:33:13.188Z",
"updatedAt": "2026-05-25T12:38:20.932Z",
"__v": 0,
"hash": "7307208218A127E8E928285CAC663D1B56740F1B",
"secureData": "TQncGYwGLAP9Nb+mMz5rPEqiBUMTw92wBb16ixtKM8hvhuynLqFi+JR4qv1f03UOYPwwOqo/lGKaW7/Hi5xEjl/0+g0GbzXmcamBNDsHytJ1GE97j/T9rwuS9RxoYQZgdCowG+oy22q5P2HTDw4bbw5FWUP4XlbXJ+Al6sf8OzRyeTd+eLF2sdh26Kj6WX+aVc+hv464gpsliNHt8OJ3s5i6wtD5QC5QbmwHzGQkqhpAnlxxStrcyay6BxYsOKQW7Xc3rXBn+8hS2Kx6ln/ynkF2XfzKQbgvsRmer/S0tWJd80zcP09LlkMMZ2OPFG/G9KH72IPr4RKzWSa8GEcPjQ=="
},
"institution": {
"_id": "68da3e6080b90fbbb96716c9",
"name": "Primetech",
"code": "primetech",
"registrationCountry": "Nigeria",
"address": {
"street": "wuse 2",
"city": "Abuja",
"state": "Abuja Federal Capital Territory",
"country": "Nigeria"
},
"emailAddress": "[email protected]",
"phoneNumber": "+2347030338024",
"websiteUrl": "https://primetech.com",
"isApproved": false,
"status": "active",
"isBlocked": false,
"createdBy": "68d56d8080b90fbbb9671426",
"users": [
"68da3e6180b90fbbb96716cb"
],
"memberships": [
"68da3e6180b90fbbb96716cd"
],
"cloudCardWalletId": "EGN8HVCKPO",
"cloudCardClientId": "67c5b11d3b1993f225c3fbab",
"createdAt": "2025-09-29T08:08:00.799Z",
"updatedAt": "2026-04-01T10:36:42.883Z",
"__v": 0
},
"mti": "0200",
"stan": "578820",
"rrn": "842395619435",
"processingCode": "000000",
"terminalId": "TERM0001",
"merchantId": "000000000000001",
"amount": 1000,
"merchantFeeAmount": 0,
"amounts": {
"amount": "000000100000",
"currency": "566"
},
"dates": {
"transmission": "Mon May 25 2026 10:49:02 GMT+0000 (Coordinated Universal Time)",
"local": "Mon May 25 2026 10:49:02 GMT+0000 (Coordinated Universal Time)",
"expiration": "2905"
},
"cardData": {
"pan": "090232fF2384",
"track2": "090232fF2384=2905601000000000000",
"_id": "6a14291e64e77fc7a0e2b3b0"
},
"tppData": null,
"nestedFields": null,
"messageType": "Unknown Message Type",
"correlationId": "578820",
"reversed": false,
"reversalId": "false",
"metadata": null,
"originalMessage": {
"0": "0200",
"2": "090232fF2384",
"3": "000000",
"4": "000000100000",
"7": "0525104902",
"11": "578820",
"12": "104902",
"13": "0525",
"14": "2905",
"22": "051",
"25": "00",
"35": "090232fF2384=2905601000000000000",
"37": "842395619435",
"40": "801",
"41": "TERM0001",
"42": "000000000000001",
"49": "566",
"102": "0117964837",
"123": "000000100000000"
},
"response": {
"39": "96"
},
"additionaldata": null,
"timestamps": {
"jcardToCardCore": {
"timestamp": "2026-05-25T10:49:02.726Z",
"direction": "inbound",
"description": "postbridge to cardcore"
},
"cardCoreToInstitution": {
"timestamp": "2026-05-25T10:49:02.787Z",
"direction": "outbound",
"description": "cardcore to institution"
},
"institutionToCardCore": {
"timestamp": "2026-05-25T10:49:02.806Z",
"direction": "inbound",
"description": "institution to cardcore"
},
"cardCoreToJcard": {
"timestamp": "2026-05-25T10:49:02.810Z",
"direction": "outbound",
"description": "cardcore to postbridge"
}
},
"isDeleted": false,
"transactionType": null,
"transactionAmount": 1000,
"transactionStatus": "failed",
"transactionAccount": null,
"transactionChannel": {
"channelType": "pos",
"detailedChannelType": "pos_chip",
"entryMode": "051",
"posConditionCode": "00",
"serviceCode": "801",
"posDataCode": "000000100000000",
"isCardPresent": true,
"isOnline": false,
"isPhysical": true,
"isAtm": false,
"timestamp": "2026-05-25T10:49:02.775Z"
},
"accounts": {
"account1": "0117964837"
},
"posData": {
"capabilities": "000000100000000"
},
"createdAt": "2026-05-25T10:49:02.729Z",
"updatedAt": "2026-05-25T10:49:02.810Z",
"__v": 0,
"duration": 103,
"responseCode": "96"
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Page number for pagination.
Required range:
x >= 1Number of records to return per page.
Required range:
x >= 1Merchant ID
Terminal ID
Available options:
active, inactive, suspended, expired Available options:
pending, completed, failed, reversed Response
200 - application/json
Transactions retrieved successfully.
The response is of type object.
⌘I