> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve payment credential > Use this endpoint to retrieve an existing payment credential. GET/digitalwallets/aliasdirectory/visa/cards/\{paymentCredentialId} Use this endpoint to retrieve an existing payment credential. ## Header parameter | Fields | Description | | - | - | | req-sys-id string Required | Identifier generated by the card program. These identifiers are used for troubleshooting requests between the card program and Marqeta. **Allowable Values:** 36 char max | | participant-id string Required | Visa Business Identifier (BID) that is assigned to the program. **Allowable Values:** Existing participant ID | ## URL path parameters | Fields | Description | | - | - | | paymentCredentialId string Required | Unique identifier of an existing payment credential. **Allowable Values:** Existing payment credential ID | ## Response body | Fields | Description | | - | - | | accountNumber string Returned | Account number of the payment credential. **Allowable Values:** 12–19 chars | | billingAddress object Returned | Billing address for the payment credential. **Allowable Values:** `country`, `addressLine1`, `addressLine2`, `buildingNumber`, `city`, `minorSubdivision`, `postalCode`, `state`, `streetName` | | billingAddress.**country** string Returned | Country of the billing address associated with the payment credential, expressed as an ISO 3166 code. For example, the numeric code for the United States is `840` and the alpha-3 code is `USA`. The ISO maintains the [full list of ISO 3166 country codes](https://www.iso.org/iso-3166-country-codes.html). **Allowable Values:** 3 chars | | billingAddress.**addressLine1** string Conditionally returned | Address line 1 of the billing address associated with the payment credential. **Allowable Values:** 99 char max | | billingAddress.**addressLine2** string Conditionally returned | Address line 2 of the billing address associated with the payment credential. **Allowable Values:** 99 char max | | billingAddress.**buildingNumber** string Conditionally returned | Building number of the billing address associated with the payment credential. **Allowable Values:** 1–60 chars | | billingAddress.**city** string Conditionally returned | City of the billing address associated with the payment credential. **Allowable Values:** 1–35 chars | | billingAddress.**minorSubdivision** string Conditionally returned | Minor subdivision of the billing address associated with the payment credential. **Allowable Values:** 1–50 chars | | billingAddress.**postalCode** string Conditionally returned | Postal code of the billing address associated with the payment credential. **Allowable Values:** 1–16 chars | | billingAddress.**state** string Conditionally returned | State of the billing address associated with the payment credential. **Allowable Values:** 1–16 chars | | billingAddress.**streetName** string Conditionally returned | Street name of the billing address associated with the payment credential. **Allowable Values:** 1–60 chars | | type string Returned | Type of payment credential associated with the Visa Alias. **Allowable Values:** `CARD` | | accountNumberType string Conditionally returned | Type of account number associated with the payment credential. **Allowable Values:** `PAN`, `NIUBIZ`, `TOKEN` | | cardType string Conditionally returned | Type of card associated with the payment credential. **Allowable Values:** 1–70 chars | | createdOn datetime Conditionally returned | Date and time when the payment credential was created. **Allowable Values:** 24 chars Format: YYYY-MM-DDTHH:MM:SS.000Z | | currencyCode string Conditionally returned | Three-digit ISO 4217 currency code for the payment credential. **Allowable Values:** 3 chars Valid three-digit [ISO 4217 currency code](https://www.iso.org/iso-4217-currency-codes.html) (Alpha-3) | | expirationDate string Conditionally returned | Expiration date of the card. **Allowable Values:** 7 chars Format: YYYY-MM | | externalId string Conditionally returned | External ID of the payment credential, which corresponds to Marqeta's card token. **Allowable Values:** 1–100 chars | | id string Conditionally returned | Unique identifier of the payment credential generated by Alias Directory. **Allowable Values:** 1–36 chars | | issuerName string Conditionally returned | Name of the issuer of the payment credential. **Allowable Values:** 1–150 chars | | lastFourDigits string Conditionally returned | Last four digits of the card number. **Allowable Values:** 4 chars | | lastUpdatedOn datetime Conditionally returned | Date and time when the payment credential was last updated. **Allowable Values:** 24 chars Format: YYYY-MM-DDTHH:MM:SS.000Z | | nameOnCard string Conditionally returned | Name on the card associated with the payment credential. **Allowable Values:** 1–120 chars | | preferredFor array of objects Conditionally returned | Indicates if a payment credential is a preferred Receiving, Sending, or Paying account. This array is returned if you passed the `preferredFor` field when creating a Visa Alias or when adding a new payment credential to an existing Visa Alias. **Allowable Values:** A valid array of `preferredFor` objects | | preferredFor\[].**type** string Returned | Type of operation associated with the payment credential. **Allowable Values:** `RECEIVE`, `SEND`, `PAY` | | preferredFor\[].**date** string Conditionally returned | Date of the Receiving, Sending, or Paying operation. **Allowable Values:** 10 chars Format: YYYY-MM-DD | | status string Conditionally returned | Status of the payment credential associated with the Visa Alias. **Allowable Values:** `ACTIVE`, `BLOCKED`, `DISABLED`, `EXPIRED` | ## Sample response body ```json JSON expandable lines wrap theme={null} [ { "accountNumber": "4111111145551142", "billingAddress": { "city": "Oakland", "state": "CA", "country": "USA", "postalCode": "94607", "streetName": "12", "addressLine1": "1000 Main Street", "addressLine2": "Suite 101", "buildingNumber": "56", "minorSubdivisionCode": "CA" }, "type": "CARD", "accountNumberType": "TOKEN", "cardType": "Visa Platinum", "createdOn": "2026-06-21T21:00:00.645Z", "currencyCode": "USD", "expirationDate": "2026-01", "externalId": "63421837-d597-4f0f-89e4-930c1a7b9e85", "id": "a44c9553-e687-4f3c-b7e7-a4245d9f238e", "issuerName": "Bank A", "lastFourDigits": "1142", "lastUpdatedOn": "2026-06-22T15:12:00.322Z", "nameOnCard": "John Smith", "preferredFor": [ { "date": "2026-01-01", "type": "RECEIVE" } ], "status": "ACTIVE" } ] ``` ## Related topics - [Visa Alias Payment Credentials Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-alias-payment-credentials.md) - [Digital Wallets Management Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management.md) - [Retrieve a Visa Alias payment credentials](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-alias-payment-credentials/retrieve-visa-alias-payment-credentials.md) - [Update payment credential](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-alias-payment-credentials/update-payment-credential.md) - [Delete an existing payment credential](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-alias-payment-credentials/delete-existing-payment-credential.md)