---
title: "Check a Genie email alias"
method: GET
path: "/v1/workspaces/{workspace_id}/genies/email-aliases/availability"
tags: ["Genies"]
---

# Check a Genie email alias

`GET /v1/workspaces/{workspace_id}/genies/email-aliases/availability`

## Request

- Base URL: `https://api.stacksync.com`
- URL: `https://api.stacksync.com/v1/workspaces/{workspace_id}/genies/email-aliases/availability`
- Auth: HTTP bearer

Whether an email alias is free for a Genie's email channel (<alias>@stacksync.email); checked in every region.

## Path parameters

- `workspace_id` integer, required

## Query parameters

- `alias` string, required: The part before @stacksync.email, without the @

## Response `200`

OK

- GenieEmailAliasAvailability
  - `alias` string, required
  - `is_available` boolean, required
  - `address` string, required
  - `reason` string, nullable: Why the alias cannot be used, or with whom it is shared; null when it is free

## Other responses

- `400`: Bad Request
- `403`: Forbidden

---

[API](https://skmtc.dev/stacksync/apis/stacksync-api.md) - [All operations](https://skmtc.dev/stacksync/apis/stacksync-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stacksync/apis/stacksync-api/revisions/21f4ba4b214e?raw)