Skip to main content
GET
/
cards
/
list
Get list of cards
curl --request GET \
  --url https://business.bfinance.app/external/api/cards/list \
  --header 'Authorization: Bearer <token>'
{
  "status": "success",
  "data": {
    "cards": [
      {
        "id": "66b123...",
        "maskedCardNumber": "411111******1111",
        "currency": "USD",
        "status": "active",
        "externalCardId": "card_ext_123",
        "cardBalance": 125.5,
        "label": "Marketing card",
        "brand": "visa",
        "cardHolder": {
          "firstName": "John",
          "lastName": "Doe",
          "customerId": "66c456..."
        },
        "cardType": "Virtual USD"
      }
    ],
    "page": 1,
    "limit": 10,
    "totalPages": 1
  }
}

Authorizations

​
Authorization
string
header
required

JWT authentication token

Query Parameters

​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
limit
integer
default:10

Number of cards per page

Required range: x >= 1
​
query
string

Search by first name, last name, full cardholder name, label, external card ID prefix, or masked card number digits

​
customerIds
string

Comma-separated list of customer IDs

Example:

"665f1...,665f2..."

​
statuses
string

Comma-separated list of card statuses

Example:

"active,frozen,pending"

Response

Successfully retrieved list of cards

​
status
string
Example:

"success"

​
data
object