> ## 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 alias internal ID

> Use this endpoint to retrieve the internal ID associated with a Visa Alias.

POST/digitalwallets/aliasdirectory/visa/aliases/aliasId

Use this endpoint to retrieve the internal ID 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 |

## Request body

| Fields | Description |
| - | - |
| aliasValue string  Optional | Visa Alias value, which can be an email, a phone number, ID of an alias directory, or a payname. If a phone number is used for the Visa Alias, it must follow ITU-T E.164 (2010) number structure. **NOTE:** In the E.164 format, the "+" sign is not included. **Allowable Values:**  1–128 chars |

## Sample request body

```json JSON expandable lines wrap theme={null}
{
  "aliasValue": "my_alias_value_1234"
}
```

## Response body

| Fields | Description |
| - | - |
| id string  Conditionally returned | UUID generated by Alias Directory, which identifies the Visa Alias. **Allowable Values:**  1–128 chars |

## Sample response body

```json JSON expandable lines wrap theme={null}
{
  "id": "my_alias_id_1234"
}
```


## Related topics

- [Visa Aliases Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases.md)
- [Digital Wallets Management Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management.md)
- [Retrieve Visa Alias by Visa Alias ID](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases/retrieve-visa-alias-by-visa-alias-id.md)
- [Retrieve Visa Alias by external ID](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-aliases/retrieve-visa-alias-by-external-id.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)