List All Transactions

POST

https://{{env}}-lb.simplifipay.com/v1/transaction

Transaction

The List All Transactions endpoint retrieves a paginated array of all the transactions carried
out in the last 90 days. The results are displayed with a default page size of 10 and the response
returns the transaction list with total no. of elements. Following are the properties of this endpoint.

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://uat-lb.simplifipay.com/v1/transaction' \
--header 'requestUuid;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardProgramUuids": [
        "string"
    ],
    "page": 0,
    "size": 0,
    "startDate": "2025-02-28 13:31:00",
    "endDate": "2025-02-28 13:31:00",
    "cardUuid": "string",
    "userUuid": "string",
    "billAmount": 0,
    "billCurrency": "string",
    "sortBy": "transactionDate",
    "sortDirection": "ASC",
    "transactionType": [
        "Auth"
    ]
}'

Response Example

{
    "transactions": [
        {
            "transactionUuid": "f0888e10-43e3-4686-9c79-256633d79559",
            "transactionId": "6712309",
            "cardUuid": "95e8008f-c14b-4d4c-bc3b-6378be83618c",
            "maskedPan": "**********1234",
            "userName": "john.smith",
            "userEmail": "user@simplifipay.com",
            "userFullName": "John Smith",
            "transactionType": "Auth",
            "statusCode": "00",
            "statusCodeDescription": "Approved",
            "authResponse": "51",
            "mccCode": "6011",
            "merchantId": "F09089372443345",
            "merchantName": "GOOGLE *TEMPORARY HOLD",
            "transactionAmount": "100.54",
            "transactionCurrency": "AED",
            "transactionDate": "2025-02-28 13:31:00",
            "billAmount": "6.95",
            "billCurrency": "AED",
            "fxFee": "0.31",
            "feeOperationType": "PRIMARY_VIRTUAL_CARD_ISSUANCE",
            "feeOperationTypeDescription": "Virtual Card Issuance Fee",
            "comments": "string"
        }
    ],
    "totalElement": 0
}

Request

Authorization

JWT

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

requestUuid

string

required

A unique id is required to be passed as part of the header whenever a SimpliFi API is called from your
system. This would help us in debugging in case of a discrepancy in the expected behavior of the API.

Example:

00d366f2-a6e9-4714-b172-02c4e58c29d8

Body Params application/json

cardProgramUuids

array[string]

optional

These are unique identifiers of the card programs.

page

integer

optional

This field contains the page number currently being displayed for transactions.

size

integer

optional

This field contains the number of the transaction records to be displayed on this page.

startDate

string <date-time>

optional

This is the start date of transactions.

Example:

2025-02-28 13:31:00

endDate

string <date-time>

optional

This is the end date of transactions.

Example:

2025-02-28 13:31:00

cardUuid

string

optional

This is a unique identifier of the card.

userUuid

string

optional

This is a unique identifier of the user.

billAmount

number

optional

This field contains the billed amount.

billCurrency

string

optional

This field contains the currency in which the amount has been billed.

sortBy

enum<string>

optional

Allowed values:

transactionDatetransactionAmount

sortDirection

enum<string>

optional

Allowed values:

ASCDESC

transactionType

array[string]

optional

This field defines the Transaction types. Allowed values are
Auth - for Authorized transactions
Reversal - for Reversed transactions
Settlement - for Settled transactions
Refund - for Refund transactions
Load - for Card Load transactions
Unload - for Card Unload transactions
Fees - for Fee transactions

Allowed values:

AuthReversalSettlementRefundLoadUnloadFees

Examples

Responses

🟢200OK

application/json

successful operation

Body

transactions

array[object (TransactionResponseDetails) {23}]

required

This array of objects is a collection of transaction fields,
possessing sub-fields explained in the rows below.

transactionUuid

string

required

This is a unique identifier of the transaction.

Example:

f0888e10-43e3-4686-9c79-256633d79559

transactionId

string

required

This is an identifier of the transaction.

Example:

6712309

cardUuid

string

required

This is a unique identifier of the card.

Example:

95e8008f-c14b-4d4c-bc3b-6378be83618c

maskedPan

string

required

Last 4 digits of the card.

Example:

**********1234

userName

string

required

username of user.

Example:

john.smith

userEmail

string

required

email of user.

Example:

user@simplifipay.com

userFullName

string

required

full name of user.

Example:

John Smith

transactionType

enum<string>

required

This is a transaction type

Allowed values:

AuthReversalSettlementRefundLoadUnloadFees

Example:

Auth

statusCode

string

required

This field contains the status code of the transaction code received from processor.

Example:

statusCodeDescription

string

optional

This field contains the status description of the transaction code received from processor.

Example:

Approved

authResponse

string

required

This field contains the auth response value of the transaction received from processor.

Example:

mccCode

string

optional

This field contains the Merchant Category Code. These, MCCs are four-digit numbers that
describe a merchant's primary business activity.

Example:

6011

merchantId

string

optional

This field contains the registered merchant ID.

Example:

F09089372443345

merchantName

string

optional

This field contains the registered merchant name.

Example:

GOOGLE *TEMPORARY HOLD

transactionAmount

number

required

This field contains the total amount that was transacted.

Example:

100.54

transactionCurrency

string

required

This field contains the currency in which the amount was transacted.

Example:

AED

transactionDate

string <date-time>

required

This field contains the date on which the transaction was carried out.

Example:

2025-02-28 13:31:00

billAmount

number

optional

This field contains the billed amount.

Example:

6.95

billCurrency

string

optional

This field contains the name of currency in which the amount is stored in the card

Example:

AED

fxFee

number

optional

This field contains the FX fee amount.

Example:

0.31

feeOperationType

string

optional

This field specifies the Fee Operation Type

Example:

PRIMARY_VIRTUAL_CARD_ISSUANCE

feeOperationTypeDescription

string

optional

This field specifies the Fee Operation Type description

Example:

Virtual Card Issuance Fee

comments

string

optional

Any notes for this transaction

totalElement

integer <int64>

required

This field contains the total number of elements against the criteria.

🟠401Unauthorized

Modified at 2025-06-27 12:44:57

Transaction

Fee