GET//////
Use this endpoint to retrieve a list of payment credentials associated with a Visa Alias.
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 |
|---|---|
| aliasId string Required | Unique identifier of the Visa Alias. Allowable Values: Existing Visa Alias 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. 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 (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
[
{
"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-21T13:00:00.000Z",
"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.000Z",
"nameOnCard": "John Smith",
"preferredFor": [
{
"date": "2026-01-01",
"type": "RECEIVE"
}
],
"status": "ACTIVE"
}
]