Skip to main content
GET
/
v1
/
cards
List cards
curl --request GET \
  --url https://api-global.fastpaybrasil.com/v1/cards \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "id": "2RhQg9M7ZCg3X3nMb9W1kX8Q",
    "token": "tok_abc123xyz",
    "maskedNumber": "****1111",
    "brand": "visa",
    "expirationMonth": "12",
    "expirationYear": "2028",
    "status": "active",
    "createdAt": "2024-01-15T10:30:00.000Z"
  }
]

Authorizations

​
Authorization
string
header
required

HTTP Basic authentication. Use your secret key as the username and an empty string as password. The API key should be base64 encoded in the format 'username:' when sending the Authorization header.

Query Parameters

​
customerId
string

Filter by customer ID

Response

Successfully retrieved the list of cards

​
id
string

Card token ID

Example:

"2RhQg9M7ZCg3X3nMb9W1kX8Q"

​
token
string

Card token

Example:

"tok_abc123xyz"

​
maskedNumber
string | null

Masked card number

Example:

"****1111"

​
brand
string

Card brand

Example:

"visa"

​
expirationMonth
string

Expiration month

Example:

"12"

​
expirationYear
string

Expiration year

Example:

"2028"

​
status
enum<string>

Card status

Available options:
pending_validation,
active,
inactive
Example:

"active"

​
createdAt
string<date-time>

Creation timestamp

Example:

"2024-01-15T10:30:00.000Z"