GET/v1/cards/:id

الحصول على بطاقة

يعيد حالة ورصيد بطاقة واحدة (دون الرقم الكامل أو CVV — انظر الكشف).

الصلاحية المطلوبة: cards.readحد الطلبات: 10 rps

المعطيات

idstringمطلوب

معرّف البطاقة.

أمثلة الكود

curl -X GET "https://samaprime.com/api/v1/cards/smsord_01J8X9AABBCCDD" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

الاستجابة

→ 200
{
  "data": {
    "id": "cm_card_01J8Z1A2BBCCDD",
    "tier": "plus",
    "status": "active",
    "last4": "1234",
    "cardholder_name": "J. Doe",
    "balance_usd": "37.0100",
    "nickname": "Groceries card",
    "expiry_month": 12,
    "expiry_year": 29
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

الأخطاء

الحالة	الرمز
404	`not_found` لا توجد بطاقة بهذا المعرّف تخص هذا المستخدم.