UPP Docs
Transaction

List transactions

GET
/transactions

The merchant's transactions, newest first, with cursor pagination. Every operation that affects the merchant balance (deposits, withdrawals, card issuing, card top-ups and withdrawals, exchanges, adjustments) is one transaction, whose status follows the operation. Card purchases are not transactions; see GET /card-transactions.

Authorization

merchantApiKeymerchantTimestampmerchantNoncemerchantSignature
headerX-API-KEY<token>

Merchant API key (starts with upk_, also accepts api-key); signing headers are also required

headerX-Timestamp<token>

Unix timestamp in seconds, within 300 seconds of server time

headerX-Nonce<token>

Unique per request; cannot be reused with the same credential during the timestamp validity window

headerX-Signature<token>

Hex HMAC-SHA256 signature (either letter case) of the method, full path, timestamp, nonce and body digest

Query Parameters

type?string

Transaction type: deposit deposit, withdrawal withdrawal (crypto withdrawal, local payout and SWIFT), withdrawal_reversal credit back of a completed withdrawal that was returned, card_issuance card issuing (initial funding and issuing fee), card_funding card top-up or withdrawal, card_refund card balance returned after termination, exchange exchange, adjustment adjustment by UPP

Value in"deposit""withdrawal""withdrawal_reversal""card_issuance""card_funding""card_refund""exchange""adjustment"
status?string

pending in progress (funds not yet available or held), completed reflected in the available balance, failed ended without affecting the available balance, reversed reversed after completion (reserved, not produced yet; a returned withdrawal keeps its transaction completed and gets a separate withdrawal_reversal transaction)

Value in"pending""completed""failed""reversed"
currency?string

Currency code, such as USDT; matches currency or counter_currency (the bought currency of an exchange, or the beneficiary's currency of a local payout or SWIFT)

customer_id?string

Only transactions for this customer (starts with cus_)

created_from?string

Created at or after (inclusive)

Formatdate-time
created_to?string

Created before (exclusive)

Formatdate-time
limit?integer

Page size, 1 to 100, default 20

Range1 <= value <= 100
cursor?string

next_cursor from the previous page

Response Body

Transactions; next_cursor is null when there are no more

application/json
  1. response
data*array<>
next_cursor*string|null
Example Request
curl -X GET 'https://sandbox.getupp.net/api/v1/transactions'
Example Response
{  "data": [    {      "id": "string",      "type": "deposit",      "status": "pending",      "amount": "string",      "currency": "string",      "fee": "string",      "fee_currency": "string",      "net": "string",      "counter_amount": "string",      "counter_currency": "string",      "customer_id": "string",      "merchant_reference": "string",      "description": "string",      "created_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z"    }  ],  "next_cursor": "string"}