> ## Documentation Index
> Fetch the complete documentation index at: https://handbook.nyotaimara.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/auth/check-email — Check If Email Is Taken

> Check whether an email is already registered on Nyota Imara. Returns exists: true or false. Use before sign-up to prevent duplicate account errors.

Check whether a given email address already has a Nyota Imara account. This endpoint is designed for pre-registration flows — call it as soon as the user finishes typing their email to prevent duplicate-account errors downstream.

**GET** `/v1/auth/check-email`

No authentication required.

## Request

<ParamField query="email" type="string" required>
  The email address to look up. The lookup is case-insensitive.
</ParamField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://api.nyotaimara.com/v1/auth/check-email?email=jane@example.com"
  ```
</CodeGroup>

## Response

<ResponseField name="success" type="boolean" required>
  `true` when the request was processed successfully.
</ResponseField>

<ResponseField name="exists" type="boolean" required>
  `true` if an account with the given email already exists, `false` otherwise.
</ResponseField>

```json theme={null}
{
  "success": true,
  "exists": false
}
```

<Note>
  **Error cases**

  | Status | Error                               | Description                                         |
  | ------ | ----------------------------------- | --------------------------------------------------- |
  | 400    | `Email query parameter is required` | The `email` query param is missing or not a string. |
  | 500    | `Internal server error`             | An unexpected server-side error occurred.           |
</Note>