API reference

Reveal card details

GET/cards/{id}/details

Returns the full card number, CVV and expiry so you can display them to the cardholder. Requires the cards:sensitive scope. GLORESEND does not store these values. Handling card numbers brings your systems into PCI DSS scope — never log or persist them.

Required scope: cards:sensitive
Idempotency-Key: Not used
Environments: Sandbox and Live

Parameters

idstring · pathrequired
max length 64

Example request

curl "https://api.gloresend.com/sandbox/v1/cards/card_9f8e7d6c5b4a3f2e1d0c/details" \
  -H "Authorization: Bearer $GLORESEND_TEST_KEY"

Response · 200

200 · application/json

{
  "object": "card_details",
  "card_id": "card_9f8e7d6c5b4a3f2e1d0c",
  "number": "4242424242424242",
  "cvv": "123",
  "expiry_month": "10",
  "expiry_year": "2029",
  "test_data": true
}

Response fields

objectenumrequired
"card_details"
card_idstringrequired
numberstringrequired
cvvstringrequired
expiry_monthstringrequired
expiry_yearstringrequired
test_databooleanrequired

Errors

401authentication_requiredNo credentials were supplied. Send Authorization: Bearer <api key>.
401invalid_api_keyThe API key is unknown, revoked or expired.
401environment_mismatchThe API key belongs to a different environment than the base URL you called. Sandbox keys (gs_test_) only work against the Sandbox base URL, Live keys (gs_live_) only against the Live base URL.
429rate_limitedToo many requests. Wait for the number of seconds in the Retry-After header.
403insufficient_scopeThe API key does not have the scope required for this endpoint.
404not_foundThe requested resource does not exist or is not visible to this API key.
409card_state_conflictThe operation is not allowed in the card's current state (for example funding a frozen or terminated card, or terminating a card that still has a balance).
502provider_errorThe downstream provider returned an error. The transfer was marked as failed and reserved funds were released.
504provider_timeoutThe downstream provider did not answer in time. The transfer was marked as failed and reserved funds were released.