List account cards
curl --request POST \
--url https://api.finup.io/backend/cards/get \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"filters": {
"status": [
"enabled",
"freezed"
],
"balance_type": [
"balance",
"limit"
],
"own": true,
"users": [
"<string>"
],
"search": "marketing",
"tag_ids": [
"<string>"
],
"bin_ids": [
"<string>"
],
"balance_min": 10,
"balance_max": 1000
},
"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: {
status: ['enabled', 'freezed'],
balance_type: ['balance', 'limit'],
own: true,
users: ['<string>'],
search: 'marketing',
tag_ids: ['<string>'],
bin_ids: ['<string>'],
balance_min: 10,
balance_max: 1000
},
pagination: {page: 1, per_page: 50, sort_by: 'created_at', sort_direction: 'desc'}
})
};
fetch('https://api.finup.io/backend/cards/get', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/cards/get"
payload = {
"filters": {
"status": ["enabled", "freezed"],
"balance_type": ["balance", "limit"],
"own": True,
"users": ["<string>"],
"search": "marketing",
"tag_ids": ["<string>"],
"bin_ids": ["<string>"],
"balance_min": 10,
"balance_max": 1000
},
"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": "67c48f6fc8614632e0b338fc",
"name": "Marketing card",
"bin": "505849",
"bin_id": "67bcf2abf8e89d31c5f8995e",
"account": "67c401f9a5b7cde210f44567",
"user": "67aa1b2c3d4e5f6789abcdef",
"holder": {
"id": "67aa1b2c3d4e5f6789abcdef",
"first_name": "Alex",
"last_name": "Morgan",
"email": "alex@example.com"
},
"status": "enabled",
"category": "business",
"currency": "USD",
"masked_PAN": "1234 56•• •••• 5678",
"EXP": "**/**",
"balance": "50.00",
"deposit": "1000.00",
"withdraw": "500.00",
"balance_type": "limit",
"limit_amount": "500.00",
"limit_period": "thirty_days",
"limit_spent": "123.45",
"balance_possibility": true,
"limit_possibility": true,
"auto_deposit": false,
"balance_threshold": "25.00",
"top_up_amount": "100.00",
"tags": [
{
"id": "67fc3d0a766d7a2c1fafefb7",
"name": "Ads",
"color": "#3B66FF"
}
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"pagination": {
"current_page": 1,
"total_records": 42,
"total_pages": 5
}
}Cards
List account cards
Filters and pagination are both optional; pagination defaults to page 1, 50 per page. Money fields are decimal strings on this endpoint.
POST
/
cards
/
get
List account cards
curl --request POST \
--url https://api.finup.io/backend/cards/get \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"filters": {
"status": [
"enabled",
"freezed"
],
"balance_type": [
"balance",
"limit"
],
"own": true,
"users": [
"<string>"
],
"search": "marketing",
"tag_ids": [
"<string>"
],
"bin_ids": [
"<string>"
],
"balance_min": 10,
"balance_max": 1000
},
"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: {
status: ['enabled', 'freezed'],
balance_type: ['balance', 'limit'],
own: true,
users: ['<string>'],
search: 'marketing',
tag_ids: ['<string>'],
bin_ids: ['<string>'],
balance_min: 10,
balance_max: 1000
},
pagination: {page: 1, per_page: 50, sort_by: 'created_at', sort_direction: 'desc'}
})
};
fetch('https://api.finup.io/backend/cards/get', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.finup.io/backend/cards/get"
payload = {
"filters": {
"status": ["enabled", "freezed"],
"balance_type": ["balance", "limit"],
"own": True,
"users": ["<string>"],
"search": "marketing",
"tag_ids": ["<string>"],
"bin_ids": ["<string>"],
"balance_min": 10,
"balance_max": 1000
},
"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": "67c48f6fc8614632e0b338fc",
"name": "Marketing card",
"bin": "505849",
"bin_id": "67bcf2abf8e89d31c5f8995e",
"account": "67c401f9a5b7cde210f44567",
"user": "67aa1b2c3d4e5f6789abcdef",
"holder": {
"id": "67aa1b2c3d4e5f6789abcdef",
"first_name": "Alex",
"last_name": "Morgan",
"email": "alex@example.com"
},
"status": "enabled",
"category": "business",
"currency": "USD",
"masked_PAN": "1234 56•• •••• 5678",
"EXP": "**/**",
"balance": "50.00",
"deposit": "1000.00",
"withdraw": "500.00",
"balance_type": "limit",
"limit_amount": "500.00",
"limit_period": "thirty_days",
"limit_spent": "123.45",
"balance_possibility": true,
"limit_possibility": true,
"auto_deposit": false,
"balance_threshold": "25.00",
"top_up_amount": "100.00",
"tags": [
{
"id": "67fc3d0a766d7a2c1fafefb7",
"name": "Ads",
"color": "#3B66FF"
}
],
"created_at": "2023-11-07T05:31:56Z"
}
],
"pagination": {
"current_page": 1,
"total_records": 42,
"total_pages": 5
}
}