List account transactions
curl --request POST \
--url https://api.finup.io/backend/transactions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"filters": {
"side": [
"debit"
],
"type": [
"card_transaction"
],
"status": [
"approved",
"pending"
],
"card_id": [
"67fc3d0a766d7a2c1fafefb8"
],
"id": [
"68b2f1c7a1d4e90012ab34cd"
],
"tag_ids": [
"67fc3d0a766d7a2c1fafefb7"
],
"merchant_category": [
"Advertising"
],
"search": "spotify",
"from_created_at": "2026-06-01T00:00:00.000Z",
"to_created_at": "2026-06-30T23:59:59.999Z",
"include_transfers": false,
"own": true,
"users": [
"67fc3d0a766d7a2c1fafefb9"
],
"timezone": "Europe/Warsaw"
},
"pagination": {
"page": 1,
"per_page": 50,
"sort_by": "created_at",
"sort_direction": "desc"
}
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
filters: {
side: ['debit'],
type: ['card_transaction'],
status: ['approved', 'pending'],
card_id: ['67fc3d0a766d7a2c1fafefb8'],
id: ['68b2f1c7a1d4e90012ab34cd'],
tag_ids: ['67fc3d0a766d7a2c1fafefb7'],
merchant_category: ['Advertising'],
search: 'spotify',
from_created_at: '2026-06-01T00:00:00.000Z',
to_created_at: '2026-06-30T23:59:59.999Z',
include_transfers: false,
own: true,
users: ['67fc3d0a766d7a2c1fafefb9'],
timezone: 'Europe/Warsaw'
},
pagination: {page: 1, per_page: 50, sort_by: 'created_at', sort_direction: 'desc'}
})
};
fetch('https://api.finup.io/backend/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/transactions"
payload = {
"filters": {
"side": ["debit"],
"type": ["card_transaction"],
"status": ["approved", "pending"],
"card_id": ["67fc3d0a766d7a2c1fafefb8"],
"id": ["68b2f1c7a1d4e90012ab34cd"],
"tag_ids": ["67fc3d0a766d7a2c1fafefb7"],
"merchant_category": ["Advertising"],
"search": "spotify",
"from_created_at": "2026-06-01T00:00:00.000Z",
"to_created_at": "2026-06-30T23:59:59.999Z",
"include_transfers": False,
"own": True,
"users": ["67fc3d0a766d7a2c1fafefb9"],
"timezone": "Europe/Warsaw"
},
"pagination": {
"page": 1,
"per_page": 50,
"sort_by": "created_at",
"sort_direction": "desc"
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"result": [
{
"id": "65fc4e136fb5c06281ac5e4e",
"account_id": "622c22cf766d7a2c1fafe2d6",
"user_id": "65fc3d09766d7a2c1fafef99",
"user": {
"id": "65fc3d09766d7a2c1fafef99",
"first_name": "Alex",
"last_name": "Morgan",
"email": "alex@example.com"
},
"status": "approved",
"side": "debit",
"amount": "150.00",
"total_amount": "151.25",
"currency": "USD",
"type": "card_transaction",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source_identifier": "1234 56•• •••• 5678",
"card": {
"id": "67c48f6fc8614632e0b338fc",
"name": "Marketing card",
"category": "business",
"masked_PAN": "1234 56•• •••• 5678"
},
"card_transaction_data": {},
"fee_data": {
"type": "crossborder"
},
"related_fees": [
{
"id": "65fc4e136fb5c06281ac5e4f",
"status": "approved",
"side": "debit",
"amount": "0.50",
"type": "fee",
"fee_data": {
"type": "crossborder"
},
"created_at": "2026-08-17T10:00:00.000Z",
"updated_at": "2026-08-17T10:00:00.000Z"
}
],
"user_transfer_data": {
"from_user_id": "65fc3d09766d7a2c1fafef99",
"to_user_id": "65fc3d09766d7a2c1fafefaa",
"from_first_name": "Alex",
"from_last_name": "Morgan",
"to_first_name": "Sam",
"to_last_name": "Rivera"
},
"account_transfer_data": {
"from_user_id": "65fc3d09766d7a2c1fafef99",
"to_user_id": "65fc3d09766d7a2c1fafefaa",
"from_first_name": "Alex",
"from_last_name": "Morgan",
"to_first_name": "Sam",
"to_last_name": "Rivera"
},
"card_deposit_data": {
"card_id": "67c48f6fc8614632e0b338fc",
"wallet_user_id": "65fc3d09766d7a2c1fafef99"
},
"card_withdraw_data": {
"card_id": "67c48f6fc8614632e0b338fc",
"wallet_user_id": "65fc3d09766d7a2c1fafef99"
},
"deposit_data": {
"tx": "0xabc123",
"currency": "USDT",
"original_amount": "150",
"network": "Tron",
"address": "TDepositAddress",
"blockchain_url": "https://tronscan.org/#/transaction/0xabc123"
},
"withdraw_data": {
"tx": "0xabc123",
"currency": "USDT",
"network": "Tron",
"address": "TWithdrawAddress",
"blockchain_url": "https://tronscan.org/#/transaction/0xabc123"
},
"rule_execution_id": "68b2f1c7a1d4e90012ab34ce"
}
],
"pagination": {
"current_page": 1,
"total_records": 42,
"total_pages": 5
}
}Transactions
List account transactions
Filters and pagination are both optional; pagination defaults to page 1, 50 per page. pagination.total_records and pagination.total_pages are always null here — call POST /transactions/count with the same body for the totals.
POST
/
transactions
List account transactions
curl --request POST \
--url https://api.finup.io/backend/transactions \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"filters": {
"side": [
"debit"
],
"type": [
"card_transaction"
],
"status": [
"approved",
"pending"
],
"card_id": [
"67fc3d0a766d7a2c1fafefb8"
],
"id": [
"68b2f1c7a1d4e90012ab34cd"
],
"tag_ids": [
"67fc3d0a766d7a2c1fafefb7"
],
"merchant_category": [
"Advertising"
],
"search": "spotify",
"from_created_at": "2026-06-01T00:00:00.000Z",
"to_created_at": "2026-06-30T23:59:59.999Z",
"include_transfers": false,
"own": true,
"users": [
"67fc3d0a766d7a2c1fafefb9"
],
"timezone": "Europe/Warsaw"
},
"pagination": {
"page": 1,
"per_page": 50,
"sort_by": "created_at",
"sort_direction": "desc"
}
}
'const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
filters: {
side: ['debit'],
type: ['card_transaction'],
status: ['approved', 'pending'],
card_id: ['67fc3d0a766d7a2c1fafefb8'],
id: ['68b2f1c7a1d4e90012ab34cd'],
tag_ids: ['67fc3d0a766d7a2c1fafefb7'],
merchant_category: ['Advertising'],
search: 'spotify',
from_created_at: '2026-06-01T00:00:00.000Z',
to_created_at: '2026-06-30T23:59:59.999Z',
include_transfers: false,
own: true,
users: ['67fc3d0a766d7a2c1fafefb9'],
timezone: 'Europe/Warsaw'
},
pagination: {page: 1, per_page: 50, sort_by: 'created_at', sort_direction: 'desc'}
})
};
fetch('https://api.finup.io/backend/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/transactions"
payload = {
"filters": {
"side": ["debit"],
"type": ["card_transaction"],
"status": ["approved", "pending"],
"card_id": ["67fc3d0a766d7a2c1fafefb8"],
"id": ["68b2f1c7a1d4e90012ab34cd"],
"tag_ids": ["67fc3d0a766d7a2c1fafefb7"],
"merchant_category": ["Advertising"],
"search": "spotify",
"from_created_at": "2026-06-01T00:00:00.000Z",
"to_created_at": "2026-06-30T23:59:59.999Z",
"include_transfers": False,
"own": True,
"users": ["67fc3d0a766d7a2c1fafefb9"],
"timezone": "Europe/Warsaw"
},
"pagination": {
"page": 1,
"per_page": 50,
"sort_by": "created_at",
"sort_direction": "desc"
}
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"result": [
{
"id": "65fc4e136fb5c06281ac5e4e",
"account_id": "622c22cf766d7a2c1fafe2d6",
"user_id": "65fc3d09766d7a2c1fafef99",
"user": {
"id": "65fc3d09766d7a2c1fafef99",
"first_name": "Alex",
"last_name": "Morgan",
"email": "alex@example.com"
},
"status": "approved",
"side": "debit",
"amount": "150.00",
"total_amount": "151.25",
"currency": "USD",
"type": "card_transaction",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"source_identifier": "1234 56•• •••• 5678",
"card": {
"id": "67c48f6fc8614632e0b338fc",
"name": "Marketing card",
"category": "business",
"masked_PAN": "1234 56•• •••• 5678"
},
"card_transaction_data": {},
"fee_data": {
"type": "crossborder"
},
"related_fees": [
{
"id": "65fc4e136fb5c06281ac5e4f",
"status": "approved",
"side": "debit",
"amount": "0.50",
"type": "fee",
"fee_data": {
"type": "crossborder"
},
"created_at": "2026-08-17T10:00:00.000Z",
"updated_at": "2026-08-17T10:00:00.000Z"
}
],
"user_transfer_data": {
"from_user_id": "65fc3d09766d7a2c1fafef99",
"to_user_id": "65fc3d09766d7a2c1fafefaa",
"from_first_name": "Alex",
"from_last_name": "Morgan",
"to_first_name": "Sam",
"to_last_name": "Rivera"
},
"account_transfer_data": {
"from_user_id": "65fc3d09766d7a2c1fafef99",
"to_user_id": "65fc3d09766d7a2c1fafefaa",
"from_first_name": "Alex",
"from_last_name": "Morgan",
"to_first_name": "Sam",
"to_last_name": "Rivera"
},
"card_deposit_data": {
"card_id": "67c48f6fc8614632e0b338fc",
"wallet_user_id": "65fc3d09766d7a2c1fafef99"
},
"card_withdraw_data": {
"card_id": "67c48f6fc8614632e0b338fc",
"wallet_user_id": "65fc3d09766d7a2c1fafef99"
},
"deposit_data": {
"tx": "0xabc123",
"currency": "USDT",
"original_amount": "150",
"network": "Tron",
"address": "TDepositAddress",
"blockchain_url": "https://tronscan.org/#/transaction/0xabc123"
},
"withdraw_data": {
"tx": "0xabc123",
"currency": "USDT",
"network": "Tron",
"address": "TWithdrawAddress",
"blockchain_url": "https://tronscan.org/#/transaction/0xabc123"
},
"rule_execution_id": "68b2f1c7a1d4e90012ab34ce"
}
],
"pagination": {
"current_page": 1,
"total_records": 42,
"total_pages": 5
}
}