# Validate email

**POST** `/v1/auth/validate-email` - Validate email for registration. Checks if email is valid format, not already registered, and associated with an organization domain. This endpoint provides real-time feedback during registration.

Validates email format, checks availability, and identifies associated organization if email domain matches.

#### Request Body

**`email`** string required

Email address to validate (1-255 characters).

## Returns

An Email Validation Response object containing validation status, organization details, and eligibility information.

**`success`** boolean

Whether the validation was successful.

**`is_valid`** boolean

Whether the email is valid for signup.

**`email`** string

The validated email address.

**`message`** string

Human-readable validation message.

**`organization`** object

Organization info if email domain is associated (optional).

**`id`** string

Organization ID (org_ prefixed).

**`name`** string

Organization name.

**`logo`** string

Organization logo URL (optional).

**`requires_invitation`** boolean

Whether the organization requires an invitation to join.

**`reason`** string

Reason for invalid email (optional). Values: `no_organization`, `already_registered`, etc.

Basic Request

```bash
curl -X POST https://api.aitronos.com/v1/auth/validate-email \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@aitronos.com"
  }'
```


```python
import requests

response = requests.post(
    "https://api.aitronos.com/v1/auth/validate-email",
    headers={"Content-Type": "application/json"},
    json={"email": "user@aitronos.com"}
)

result = response.json()
print(result)
```


```javascript
const response = await fetch('https://api.aitronos.com/v1/auth/validate-email', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'user@aitronos.com'
  })
});

const result = await response.json();
console.log(result);
```

**Response:**

200 OK - Valid Email

```json
{
  "success": true,
  "is_valid": true,
  "email": "user@aitronos.com",
  "organization": {
    "id": "org_1234567890abcdef",
    "name": "Aitronos",
    "requires_invitation": false
  },
  "message": "Email is valid for signup"
}
```

200 OK - Invalid Domain

```json
{
  "success": false,
  "is_valid": false,
  "email": "user@unknown.com",
  "message": "This email domain is not authorized for signup",
  "reason": "no_organization"
}
```

200 OK - Already Registered

```json
{
  "success": false,
  "is_valid": false,
  "email": "existing@aitronos.com",
  "message": "This email is already registered",
  "reason": "email_already_registered"
}
```

400 Bad Request

```json
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email format",
    "status": 400
  }
}
```

500 Server Error

```json
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred",
    "status": 500
  }
}
```