NEnestechops
ledger-card accounts

Get a card account with its sensitive details (PAN/CVV/expiry) revealed.

Changed on

As GET /card-accounts/{cardAccountId}, but also returns the card's PAN/CVV/expiry, RSA-encrypted for transport with the caller-supplied public key (X-Public-Key header, base64-encoded DER/X.509 SubjectPublicKeyInfo) - mirrors onboard-wallet-cards' includeDetails/public-key reveal flow. Requires the MANAGE permission specifically, stricter than the plain read above, since a business has multiple users at different permission tiers.

get/ledger/card-accounts/{cardAccountId}/details

Request

Path parameters

cardAccountIdstring uuid required

The unique card account ID

Headers

X-Public-Keystring required

Base64-encoded DER (X.509 SubjectPublicKeyInfo) RSA public key.

Response

Card account with encrypted sensitive details fetched successfully

idstring uuid required

Unique card account ID.

accountIdstring uuid required

The MAIN account this card is funded from.

currencystring required
status'PENDING_KYC' | 'PENDING_PROVISIONING' | 'ACTIVE' | 'FROZEN' | 'TERMINATED' | 'KYC_REJECTED' | 'CREATION_FAILED' required

Lifecycle of a card account. PENDING_KYC and PENDING_PROVISIONING are transient - a card only starts moving money once it reaches ACTIVE. KYC_REJECTED and CREATION_FAILED are terminal with no funds ever moved (the dedicated ledger account is only created once KYC is approved).

balancenumber required

The card's live spendable balance.

failureReasonstring

Populated when status is KYC_REJECTED or CREATION_FAILED.

createdDatestring date-time required

Example response

{
  "currency": "USD"
}

Changes

  • 5b7b2c163546Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 1805362fe220Revision changes
    • info

      endpoint added