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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

page
integer
default:1

Page number for pagination.

Required range: x >= 1
limit
integer
default:20

Number of records to return per page.

Required range: x >= 1
id
string
isDeleted
boolean
localid
string
node
string
acquirer
string
mid
string

Merchant ID

tid
string

Terminal ID

stan
string
rrn
string
mcc
number
functioncode
string
reasoncode
string
responsecode
string
currencycode
string
card
string
account
string
wallet
string
tags
string
dateFrom
string<date>
dateTo
string<date>
transmissiondateFrom
string<date>
transmissiondateTo
string<date>
amountMin
number
amountMax
number
cardStatus
enum<string>
Available options:
active,
inactive,
suspended,
expired
cardType
string
cardScheme
string
cardNumber
string
cardholderName
string
cardholderEmail
string
cardholderPhone
string
cardBin
string
processingCode
string
transactionStatus
enum<string>
Available options:
pending,
completed,
failed,
reversed

Response

200 - application/json

Transactions retrieved successfully.

The response is of type object.