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