Skip to main content
GET
/
v1
/
cards
/
:id
/
details
curl https://api.usenaive.ai/v1/cards/card-uuid-1/details \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "card_id": "card-uuid-1",
  "provider": "managed_virtual",
  "number": "4242424242424242",
  "cvc": "123",
  "exp_month": 12,
  "exp_year": 2028,
  "cardholder_name": "John Doe",
  "billing_address": {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }
}
Retrieves the sensitive card credentials. Response format depends on the card provider. 
curl https://api.usenaive.ai/v1/cards/card-uuid-1/details \
  -H "Authorization: Bearer nv_sk_live_..."

{
  "card_id": "card-uuid-1",
  "provider": "managed_virtual",
  "number": "4242424242424242",
  "cvc": "123",
  "exp_month": 12,
  "exp_year": 2028,
  "cardholder_name": "John Doe",
  "billing_address": {
    "line1": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "postal_code": "94105",
    "country": "US"
  }
}

​
Response by Provider

Managed virtual cards (provider: "managed_virtual"):
FieldTypeDescription
card_idstringCard UUID
numberstringFull card number (16 digits)
cvcstring3-digit security code
exp_monthnumberExpiration month (1-12)
exp_yearnumberExpiration year (4 digits)
cardholder_namestringName on card
billing_addressobjectBilling address details
Prepaid gift cards (provider: "prepaid_gift"):
FieldTypeDescription
card_idstringCard UUID
numberstringRedeem code
pinstringPIN code
typestringprepaid_gift

​
CLI

naive cards details <id>

​
MCP

Tool: naive_cards_details 
{
  "card_id": "card-uuid-1"
}