Summarize filtered transactions
curl --request POST \
--url https://api.finup.io/backend/transactions/summary \
--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/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/transactions/summary"
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){
"spent": "1250.00",
"incoming": "2500.00",
"fees": "15.00",
"declined": "0.00",
"net": "1235.00"
}Transactions
Summarize filtered transactions
Aggregates the whole filtered set, not just the current page. Card funding and same-account member transfers are net-zero within the account and are excluded from both spent and incoming.
POST
/
transactions
/
summary
Summarize filtered transactions
curl --request POST \
--url https://api.finup.io/backend/transactions/summary \
--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/summary', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/transactions/summary"
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){
"spent": "1250.00",
"incoming": "2500.00",
"fees": "15.00",
"declined": "0.00",
"net": "1235.00"
}Authorizations
Response
Success
Decimal money string in USD.
Example:
"1250.00"
Decimal money string in USD.
Example:
"2500.00"
Decimal money string in USD.
Example:
"15.00"
Decimal money string in USD.
Example:
"0.00"
incoming − spent − fees. Decimal money string in USD.
Example:
"1235.00"