Virtual Cards – API Endpoint Reference

action	method & endpoint	description
Create Card	POST /api/cards	Issues a new virtual or physical card for a customer.
Get Card	GET /api/cards/:cardId	Retrieves general card information including balance and status.
Get Card Secure Details	GET /api/cards/:cardId/secure	Retrieves sensitive card details including full card number, expiry, and CVV.
List Cards	GET /api/cards	Retrieves a paginated list of all cards under your company.
Fund or Withdraw Card	POST /api/cards/:cardId/balance	Adjusts a card's balance. Send a positive amount to fund, a negative amount to withdraw back to your account.
Freeze or Unfreeze Card	POST /api/cards/:cardId/status	Toggles the card between 'active' and 'frozen'. Freezing suspends transacting; unfreezing resumes it.
Terminate Card	DELETE /api/cards/:cardId	Permanently deactivates the card. Cannot be reversed, and cannot be called within 24 hours of card creation.
Update Spending Limits	PUT /api/cards/:cardId/spend-limits	Updates the spending limits on a card.
Get Cards by Customer	GET /api/customers/:customerId/cards	Retrieves all cards belonging to a specific customer.

Base URL for all endpoints: https://api.bitnob.com