Skip to main content
POST
/
v1
/
cards
/
{cardId}
/
details
Get card credentials
curl --request POST \
  --url https://api.ledger.so/v1/cards/{cardId}/details \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "summary": "<string>",
  "expectedAmount": 123,
  "expectedCurrency": "USD",
  "merchantText": "<string>",
  "reason": "one-time",
  "clientContext": {}
}
'
{
  "accessEventId": "<string>",
  "exposureMode": "extensionOnly",
  "last4": "<string>",
  "detailsToken": "<string>",
  "tokenExpiresAt": 123,
  "pan": "<string>",
  "cvv": "<string>",
  "expirationMonth": "<string>",
  "expirationYear": "<string>"
}

Authorizations

​
Api-Key
string
header
required

API key for authentication. Get your key from the Dashboard.

Path Parameters

​
cardId
string
required

The card ID

Body

application/json
​
summary
string
required

Human-readable description of intended use

​
expectedAmount
integer

Expected transaction amount in cents

​
expectedCurrency
string
default:USD
​
merchantText
string

Expected merchant name

​
reason
enum<string>
Available options:
one-time,
subscription,
preauth
​
clientContext
object

Custom context for your records

Response

Card credentials

​
accessEventId
string
required

ID of the credential access event

​
exposureMode
enum<string>
required
Available options:
extensionOnly,
rawPan
​
last4
string
required
​
detailsToken
string

Token for extension redemption (extensionOnly mode)

​
tokenExpiresAt
integer

Token expiration timestamp (extensionOnly mode)

​
pan
string

Card number (rawPan mode only)

​
cvv
string

CVV (rawPan mode only)

​
expirationMonth
string
​
expirationYear
string