Get Alias

Retrieve a single email alias.

GET /domains/:domain_name/aliases/:alias_id

Example: /domains/example.com/aliases/alias_01k3tgwp77e19ass89t1c6da94

Path Parameters

domain_name string required

The domain name of the alias.

alias_id string required

The alias ID.

Example

curl -X GET https://api.mailcast.io/v1/domains/:domain_name/aliases/:alias_id \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json"

Response 200

{
  "id": "alias_01k3tgwp77fdmvgcpj624rwntj",
  "match": "support",
  "state": "active",
  "actions": [
    {
      "type": "forward",
      "recipient": "company+support@gmail.com",
      "state": "active"
    }
  ],
  "created_at": "2025-08-29T12:00:00Z",
  "updated_at": "2025-08-29T12:00:00Z"
}