List Credit Cards

This endpoint returns a paginated list of credit cards with optional filters.

Authorization:

bearer

HTTP: bearer

HTTP Authorization Scheme: bearer

Headers:
  Authorization: APIKey {YOUR_API_KEY}

Endpoint

GET

/api/v2/cards

Query Parameters

Parameter	Type	Description
page	int	Page number (default: 1).
limit	int	Number of items per page (default: 20).
accountId	uuid	Filter by Account ID.

Response Sample

{
  "page": 1,
  "limit": 20,
  "total": 1,
  "data": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "accountId": "00000000-0000-0000-0000-000000000000",
      "cardNumberLast4": "1111",
      "maskedCardNumber": "****-****-****-1111",
      "cardHolderName": "John Wick",
      "expMonth": 12,
      "expYear": 2026,
      "status": "active",
      "billingAddress": {
        "address1": "123 Main St",
        "address2": "Apt 4B",
        "city": "New York",
        "state": "NY",
        "postalCode": "10001",
        "country": "US"
      },
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ]
}

Response Schema

Field	Type	Description
id	string (uuid)	Unique identifier for the card.
accountId	string (uuid)	Account ID the card belongs to.
cardNumberLast4	string	Last 4 digits of the card number.
maskedCardNumber	string	Masked card number (e.g., ****-****-****-1111).
cardHolderName	string	Name on the card.
expMonth	int	Expiration month (1-12).
expYear	int	Expiration year.
status	string	Card status: pending, active, inactive, expired, failed.
billingAddress	object	Billing address associated with the card.
createdAt	string (ISO 8601)	Timestamp when the card was created.
updatedAt	string (ISO 8601)	Timestamp when the card was last updated.

Support and Resources

If you need assistance or have any questions, our support team is here to help. You can contact our support team at support@blockwyre.com.

Stay Updated

Stay up-to-date with the latest news, updates, and features from BlockWyre by following us on social media:

• Instagram: BlockWyre Instagram
• Twitter: BlockWyre Twitter
• Facebook: BlockWyre Facebook
• LinkedIn: BlockWyre LinkedIn

We are excited to have you on board and look forward to seeing how you leverage BlockWyre's powerful tools to enhance your financial operations. Happy integrating!