Skip to main content
GET
/
api
/
v1
/
transactions
List Transactions (without pagination)
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.valox.co/api/v1/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
[
  {
    "threadId": "1234567890",
    "createdAt": "2023-11-07T05:31:56Z",
    "clearedAt": "2023-11-07T05:31:56Z",
    "country": {
      "name": "<string>",
      "numeric": "<string>",
      "alpha2": "<string>",
      "alpha3": "<string>"
    },
    "isPending": true,
    "mcc": "<string>",
    "merchant": {
      "name": "<string>",
      "city": "<string>",
      "country": {
        "name": "<string>",
        "numeric": "<string>",
        "alpha2": "<string>",
        "alpha3": "<string>"
      }
    },
    "billingAmount": "<string>",
    "billingCurrency": {
      "symbol": "<string>",
      "code": "<string>",
      "decimals": 123,
      "name": "<string>"
    },
    "transactionAmount": "<string>",
    "transactionCurrency": {
      "symbol": "<string>",
      "code": "<string>",
      "decimals": 123,
      "name": "<string>"
    },
    "transactionType": "<string>",
    "cardToken": "<string>",
    "transactions": [
      {
        "status": "Unsubmitted",
        "to": "<string>",
        "value": "<string>",
        "data": "<string>",
        "hash": "<string>"
      }
    ],
    "kind": "Payment",
    "status": "Approved"
  }
]

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
cardTokens
string

Comma-separated list of card tokens

​
before
string<date-time>

Filter transactions before this date (ISO 8601 format, e.g., "2023-04-01T00:00:00Z")

​
after
string<date-time>

Filter transactions after this date (ISO 8601 format, e.g., "2023-03-01T00:00:00Z")

​
billingCurrency
string

Filter by billing currency code

​
transactionCurrency
string

Filter by transaction currency code

​
mcc
string

Filter by Merchant Category Code (MCC)

​
transactionType
string

Filter by transaction type code (e.g., "00" for Purchase, "01" for Withdrawal)

Response

Successful response

  • Option 1
  • Option 2
  • Option 3
​
threadId
string

Thread ID for the transaction

Example:

"1234567890"

​
createdAt
string<date-time>
​
clearedAt
string<date-time> | null

Date of the latest clearing record of the transaction

​
country
object
​
isPending
boolean

Whether the transaction is pending settlement.

  • For Payments: true when authorized but not yet cleared, false when settled
  • For Refunds: can be true if additional clearing steps are pending, typically false since they require both auth + clearing to appear
  • For Reversals: typically false as they're usually processed quickly
​
mcc
string
​
merchant
object
​
billingAmount
string

A BigInt value represented as a string

​
billingCurrency
object
​
transactionAmount
string

A BigInt value represented as a string

​
transactionCurrency
object
​
transactionType
string

First 2 digits of the DE3 field (ISO 8583), representing the transaction type code. Common values include (not limited to):

  • "00": Purchase (POS)
  • "01": Withdrawal (ATM)
  • "10": Account Funding
  • "20": Return of Goods
  • "28": Prepaid Load
  • "30": Balance Inquiry
  • "70": PIN Change
  • "72": PIN Unblock
​
cardToken
string

The token identifying the card used for this transaction

​
transactions
object[]
​
kind
enum<string>
Available options:
Payment
​
status
enum<string>
Available options:
Approved,
IncorrectPin,
InsufficientFunds,
ExceedsApprovalAmountLimit,
InvalidAmount,
PinEntryTriesExceeded,
IncorrectSecurityCode,
Reversal,
PartialReversal,
Other