Cards
Get account cards
Cards
Get account cards
POST
/
accounts
/
{account_id}
/
cards
curl --request POST \
--url https://api.finup.io/accounts/{account_id}/cards \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"filters": {
"bin": [
"<string>"
],
"status": "[\"Enabled\", \"Canceled\"]",
"currency": [
"<string>"
],
"category": [
"<string>"
],
"balance_from": 123,
"balance_to": 123,
"search": "<string>"
},
"pagination": {}
}'
{
"result": {
"id": "67c48f6fc8614632e0b338fc",
"name": "Approved",
"bin_id": "67bcf2abf8e89d31c5f8995e",
"notes": "Credit",
"status": "Pending",
"user": "67aa1b2c3d4e5f6789abcdef",
"EXP": "**/**",
"account": "67c401f9a5b7cde210f44567",
"balance": 50,
"deposit": 1000,
"withdraw": 500,
"spent": 450,
"masked_PAN": "1234 56•• •••• ••••",
"currency": "EUR",
"category": "Business",
"created_at": "2025-03-21T14:30:10.123Z",
"past_balance": 75,
"future_balance": 125
}
}
Headers
API key for authentication
Path Parameters
Id of account
Body
application/json
Body
List of allowable BINs.
Available options:
Enabled
, Closed
, Closing
, Freezing
, Unreezing
, Freezed
, Processing
, Blocked
Example:
"[\"Enabled\", \"Canceled\"]"
A list of allowable currencies. Pass the currency ID.
A list of allowable categories.
A filtering parameter that specifies the minimum balance value. Only objects with balance exceeding this value are returned
A filtering parameter that specifies the maximum balance value. Only objects with balance that do not exceed this value are returned
Parameter that searches by substring.
Response
201
application/json
Card created successfully
Example:
"67c48f6fc8614632e0b338fc"
Example:
"Approved"
Example:
"67bcf2abf8e89d31c5f8995e"
Example:
"Credit"
Example:
"Pending"
Example:
"67aa1b2c3d4e5f6789abcdef"
Example:
"**/**"
Example:
"67c401f9a5b7cde210f44567"
Example:
50
Example:
1000
Example:
500
Example:
450
Example:
"1234 56•• •••• ••••"
Example:
"EUR"
Example:
"Business"
Example:
"2025-03-21T14:30:10.123Z"
Example:
75
Example:
125
curl --request POST \
--url https://api.finup.io/accounts/{account_id}/cards \
--header 'Content-Type: application/json' \
--header 'x-api-key: <x-api-key>' \
--data '{
"filters": {
"bin": [
"<string>"
],
"status": "[\"Enabled\", \"Canceled\"]",
"currency": [
"<string>"
],
"category": [
"<string>"
],
"balance_from": 123,
"balance_to": 123,
"search": "<string>"
},
"pagination": {}
}'
{
"result": {
"id": "67c48f6fc8614632e0b338fc",
"name": "Approved",
"bin_id": "67bcf2abf8e89d31c5f8995e",
"notes": "Credit",
"status": "Pending",
"user": "67aa1b2c3d4e5f6789abcdef",
"EXP": "**/**",
"account": "67c401f9a5b7cde210f44567",
"balance": 50,
"deposit": 1000,
"withdraw": 500,
"spent": 450,
"masked_PAN": "1234 56•• •••• ••••",
"currency": "EUR",
"category": "Business",
"created_at": "2025-03-21T14:30:10.123Z",
"past_balance": 75,
"future_balance": 125
}
}