Skip to main content
GET
/
v0
/
transactions
List user transactions
curl --request GET \
  --url https://api.sumvin.com/v0/transactions/
{
  "_links": {
    "self": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    },
    "first": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    },
    "prev": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    },
    "next": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    },
    "last": {
      "href": "<string>",
      "method": "GET",
      "templated": false,
      "description": "<string>"
    }
  },
  "transactions": [
    {
      "id": "<string>",
      "type": "<string>",
      "status": "<string>",
      "direction": "<string>",
      "amount": "<string>",
      "asset": {
        "symbol": "<string>",
        "name": "<string>",
        "asset_type": "<string>",
        "decimals": 123,
        "chain_id": 123,
        "contract_address": "<string>"
      },
      "created_at": 123,
      "updated_at": 123,
      "source": "<string>",
      "wallet": {
        "id": "<string>",
        "address": "<string>",
        "chain_id": 123,
        "is_primary": true,
        "is_eoa": true
      },
      "account": {
        "id": "<string>",
        "provider": "<string>",
        "account_type": "<string>",
        "institution_name": "<string>",
        "account_name": "<string>",
        "account_mask": "<string>",
        "nickname": "<string>"
      },
      "card": {
        "last_four": "<string>",
        "brand": "<string>",
        "card_type": "<string>"
      },
      "tx_hash": "<string>",
      "merchant_name": "<string>",
      "merchant_logo_url": "<string>",
      "merchant_category_code": "<string>",
      "category": "<string>",
      "processor_reference": "<string>"
    }
  ],
  "total": 123,
  "offset": 123,
  "limit": 123,
  "meta": {
    "transaction_count": 123,
    "cashflow": {
      "gross_in": "<string>",
      "gross_out": "<string>",
      "net": "<string>"
    },
    "categories": [
      {
        "category": "<string>",
        "total_amount": "<string>",
        "percentage_of_total": "<string>",
        "transaction_count": 123
      }
    ],
    "date_range": {
      "earliest": "<string>",
      "latest": "<string>"
    }
  }
}

Headers

​
x-juno-orgid
string | null

Tenant org ID for multi-tenant auth

​
x-sumvin-token
string | null
​
x-juno-jwt
string | null
​
x-sumvin-pint-token
string | null

Query Parameters

​
source
enum<string> | null

Filter by transaction source Origin system for a transaction. Used to filter transactions by funding source.

  • crypto_wallet - On-chain transaction from user's EOA or Safe wallet
  • bank_account - ACH/wire transfer from linked bank account
  • card - Debit card purchase or refund
Available options:
crypto_wallet,
bank_account,
card
​
account_id
string | null

Filter by account ID

​
wallet_id
string | null

Filter by wallet id

​
card_id
string | null

Filter by card id

​
type
enum<string> | null

Filter by transaction type Classification of financial transaction types.

Crypto/Wallet transactions:

  • deposit - Incoming transfer to user's wallet from external source
  • withdrawal - Outgoing transfer from user's wallet to external address
  • transfer - Internal movement between user's own wallets
  • swap - Token exchange (e.g., ETH → USDC)
  • on_ramp - Fiat-to-crypto conversion via exchange/provider
  • off_ramp - Crypto-to-fiat conversion via exchange/provider

Card transactions:

  • card_purchase - Debit card spend at merchant
  • card_refund - Merchant-initiated refund to card

Bank account transactions:

  • bank_transfer - ACH/wire transfer between accounts
  • direct_debit - Recurring automated payment (bills, subscriptions)
  • standing_order - Scheduled fixed payment
  • bank_payment - One-time outgoing payment
  • bank_refund - Return of funds to bank account
  • interest - Interest credit on savings/checking account
  • fee - Bank service charge or maintenance fee
Available options:
deposit,
withdrawal,
transfer,
swap,
card_purchase,
card_refund,
on_ramp,
off_ramp,
bank_transfer,
direct_debit,
standing_order,
bank_payment,
bank_refund,
interest,
fee
​
status
enum<string> | null

Filter by transaction status Lifecycle state of a transaction.

State progression: pending → processing → completed | failed | cancelled

  • pending - Transaction created but not yet submitted for processing
  • processing - Submitted to network/provider, awaiting confirmation
  • completed - Successfully finalized (on-chain confirmed or bank settled)
  • failed - Transaction rejected or reverted (check error details)
  • cancelled - User or system cancelled before completion
Available options:
pending,
processing,
completed,
failed,
cancelled
​
direction
enum<string> | null

Filter by transaction direction Direction of fund flow relative to user's account.

  • in - Funds entering user's account (credits, deposits, refunds)
  • out - Funds leaving user's account (debits, payments, withdrawals)
Available options:
in,
out
​
category
string | null

Filter by category. Comma-separated for OR logic (e.g., 'groceries,restaurants,coffee')

​
merchant_name
string | null

Filter by merchant name (case-insensitive partial match)

​
merchant_category_code
string | null

Filter by merchant category code (4-digit MCC)

​
amount_min

Filter transactions with amount >= this value

​
amount_max

Filter transactions with amount <= this value

​
from_date
string | null

Filter transactions on or after this date. Accepts epoch ms or YYYY-MM-DD

​
to_date
string | null

Filter transactions on or before this date. Accepts epoch ms or YYYY-MM-DD

​
offset
integer
default:0

Pagination offset

Required range: x >= 0
​
limit
integer
default:50

Pagination limit

Required range: 1 <= x <= 100
​
meta
boolean
default:false

Include meta statistics about returned transactions

Response

Transactions retrieved successfully

Paginated list of transactions with optional metadata.

​
_links
PaginationLinks · object
required

HAL-style hypermedia links for navigation.

​
transactions
TransactionData · object[]
required

List of transactions

​
total
integer
required

Total number of transactions matching filters

​
offset
integer
required

Current pagination offset

​
limit
integer
required

Maximum results per page

​
meta
TransactionMeta · object

Aggregate statistics (only present when meta=true)