Skip to content
Last updated

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.

POSThttps://api.aitronos.com/v1/auth/validate-email

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).

Show organization object properties

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.

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

Response:

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