1. Management
Vrtx Docs
  • Auth
    • Token
      POST
  • Onboarding
    • Start onboarding
      POST
    • Verify onboarding OTP
      POST
    • Resend onboarding OTP
      POST
    • Get session status
      GET
    • Initiate Nafath
      POST
    • Cancels session
      POST
    • Complete customer info
      POST
  • Webhooks
    • Process Nafath webhook
      POST
    • Process Faceki webhook
      POST
    • Process T2 webhook
      POST
  • Wallet
    • Change mobile number from profile settings
      • Change mobile number
      • Verify mobile number change OTP
      • Get mobile change status
    • Change mobile number from login screen
      • Change mobile number
      • Verify mobile number change OTP
      • Initiate Nafath
      • Get mobile number change status
  • Businesses
    • Create business
      POST
  • Transactions
    • Business Accounts
      • Get business account balance
      • Get transaction details
      • List business transactions
    • Wallet Accounts
      • Get wallet balance
      • List wallet transactions
  • Payouts
    • Create payout
    • Get payout status
    • Create bulk payout
    • Get bulk payout status
    • Get batch report
  • Cards
    • Issuance
      • Issue card
      • Get card issuance
      • Complete card issuance
      • Verify card issuance OTP
      • Convert virtual to physical
      • Verify card conversion OTP
    • Management
      • Get card
        GET
      • Change card status
        PATCH
      • Set or update card PIN
        POST
      • Verify card PIN OTP
        POST
      • Activate physical card
        POST
      • Verify activation OTP
        POST
      • Display sensitive data
        POST
      • Verify display sensitive data OTP
        POST
  • cards
    • Initiate card replacement
    • Verify OTP and complete card replacement
Open-Loop-v2Closed-loop V2Card Simulatoropen-loop-test
Open-Loop-v2Closed-loop V2Card Simulatoropen-loop-test
  1. Management

Get card

GET
/cards/{id}
Last modified:2025-12-02 10:06:51
Retrieves a card by its unique identifier, including status, token, last four digits,
and lifecycle timestamps.
Card Status Values:
UNSPECIFIED
ACTIVE
INACTIVE
CANCELLED
Error Responses (only these codes are returned):
400 INVALID_INPUT
403 ACCOUNT_NOT_ELIGIBLE
404 CARD_NOT_FOUND
409 CARD_LIMIT_REACHED
503 SERVICE_UNAVAILABLE

Request

Path Params

Responses

🟢200Success
application/json
Default Response
Body

đźź 400400
đźź 401401
đźź 403403
đźź 404404
đźź 405405
đźź 409409
đźź 410410
đźź 422422
đźź 429429
đź”´500500
đź”´501501
đź”´503503
đź”´504504
đź”´505505
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/cards/'
Response Response Example
200 - example1
{
    "id": "f5a4b3c2-d1e0-9876-5432-1a0b9c8d7e6f",
    "account_id": "b2c3d4e5-f6a7-5890-b123-c4d5e6f7a8b9",
    "token": 987654321,
    "status": "LOCKED",
    "last_4_digits": "8765",
    "expiry_date": "2026-06-30",
    "design": "premium",
    "created_at": "2023-12-01T08:15:00Z",
    "updated_at": "2024-01-10T14:20:00Z",
    "is_physical": true,
    "physical_card_activation_status": "ACTIVATED",
    "physical_activated_at": "2024-02-01T09:00:00Z"
}
Modified at 2025-12-02 10:06:51
Previous
Verify card conversion OTP
Next
Change card status
Built with