Email Verification API v1.0

1. Resend Verification Code

Use this endpoint to request a new verification code for an unverified user.

curl -X POST https://api.wecompleteapp.com/api/auth/resend-verification \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com"
  }'

Success Response

{
  "success": true,
  "message": "Verification code sent to your email",
  "userId": "user_123"
}

Error Responses

User Not Found (404)

{
  "success": false,
  "code": "user_not_found",
  "message": "No user found with this email address"
}

Already Verified (400)

{
  "success": false,
  "code": "already_verified",
  "message": "This email is already verified"
}

Email Failed (500)

{
  "success": false,
  "code": "email_failed",
  "message": "Failed to send verification email"
}

2. Verify Email

Use this endpoint to verify a user's email with the verification code.

curl -X POST https://api.wecompleteapp.com/api/auth/verify-email \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_123",
    "verificationCode": "12345"
  }'

Success Response

{
  "success": true,
  "message": "Email verified successfully",
  "token": "long-term-authentication-token"
}

Error Response

{
  "success": false,
  "code": "invalid_code",
  "message": "Invalid verification code"
}