List Aliases
Retrieve all email aliases for a domain.
GET
/domains/:domain_name/aliases
Example:
/domains/example.com/aliases
Path Parameters
domain_name
string
required
The domain name for which to list aliases.
Example
curl -X GET https://api.mailcast.io/v1/domains/:domain_name/aliases \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"
Response
200
{
"aliases": [
{
"id": "alias_01k3tgwp77eny92yz9rbw65pf5",
"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"
},
{
"id": "alias_01k3tgwp78e259gy2pyjfn5nht",
"match": "*",
"state": "active",
"actions": [
{
"type": "passthrough",
"mx_servers": [
{
"host": "smtp.google.com",
"priority": 10
}
],
"state": "active"
}
],
"created_at": "2025-08-29T11:00:00Z",
"updated_at": "2025-08-29T11:00:00Z"
},
{
"id": "alias_01k3tgwp79edzr1vrgfx54n2yv",
"match": "/\\w+/",
"state": "active",
"actions": [
{
"type": "webhook",
"endpoint": "https://example.com/webhook",
"method": "post",
"format": "json",
"fields": ["from", "to", "subject"],
"headers": [],
"extra_fields": [],
"state": "active"
}
],
"created_at": "2025-08-29T10:00:00Z",
"updated_at": "2025-08-29T10:00:00Z"
}
]
}