Get account cards

curl --request POST \
  --url https://api.finup.io/backend/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
  }
}

POST

accounts

{account_id}

cards

Get account cards

curl --request POST \
  --url https://api.finup.io/backend/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

x-api-key

string

required

API key for authentication

Path Parameters

account_id

string

required

Id of account

Body

application/json

Body

filters

object

required

Show child attributes

filters.bin

string[]

List of allowable BINs.

filters.status

enum<string>[]

Available options:

Enabled,

Closed,

Closing,

Freezing,

Unreezing,

Freezed,

Processing,

Blocked

Example:

"[\"Enabled\", \"Canceled\"]"

filters.currency

string[]

A list of allowable currencies. Pass the currency ID.

filters.category

string[]

A list of allowable categories.

filters.balance_from

number

A filtering parameter that specifies the minimum balance value. Only objects with balance exceeding this value are returned

filters.balance_to

number

A filtering parameter that specifies the maximum balance value. Only objects with balance that do not exceed this value are returned

filters.search

string

Parameter that searches by substring.

pagination

object

required

Response

Card created successfully

result

object

Show child attributes

result.id

string

Example:

"67c48f6fc8614632e0b338fc"

result.name

string

Example:

"Approved"

result.bin_id

string

Example:

"67bcf2abf8e89d31c5f8995e"

result.notes

string

Example:

"Credit"

result.status

string

Example:

"Pending"

result.user

string

Example:

"67aa1b2c3d4e5f6789abcdef"

result.EXP

string

Example:

"**/**"

result.account

string

Example:

"67c401f9a5b7cde210f44567"

result.balance

number

Example:

50

result.deposit

number

Example:

1000

result.withdraw

number

Example:

500

result.spent

number

Example:

450

result.masked_PAN

string

Example:

"1234 56•• •••• ••••"

result.currency

string

Example:

"EUR"

result.category

string

Example:

"Business"

result.created_at

string<date-time>

Example:

"2025-03-21T14:30:10.123Z"

result.past_balance

number

Example:

75

result.future_balance

number

Example:

125

Card withdraw Get specified account card

⌘I

Banking API

Headers

Path Parameters

Body

Response