Email Verification

Complete email verification suite for Bots.Business platform. Send verification bots to users' Bots.Business accounts via their email address.

Why This API Is Helpful

This API verifies the actual ownership of a Bots.Business account. It confirms that the email address provided is truly registered with Bots.Business and that the user has legitimate access to that account.

Verify that a user actually owns the Bots.Business email they claim

Confirm the email address is valid and registered on Bots.Business platform

Prevent fake or unauthorized account access attempts

Ensure only legitimate Bots.Business users can access your service

Build trust by validating user email

Key Point: The API does NOT just check email format it actively verifies ownership by sending a bot to the user's Bots.Business account and requiring them to retrieve a unique OTP code from their bot's Commands section.

Verification Flow

Submit Email

User enters email address associated with their Bots.Business account.

Request Verification

Your system calls the verify-email endpoint to request email verification.

Receive Bot

A verification bot is sent to the user's Bots.Business email address.

Retrieve OTP

User opens the bot, navigates to Commands section, clicks on the command name, and sees the OTP verification code in the Code Editor panel.

Verify OTP

User provides OTP code on your platform. Your system calls verify-otp endpoint for validation.

Verification Complete

Email is verified. You now know the user legitimately owns that Bots.Business account.

Important: The API does NOT send emails to regular email addresses. The "email" field identifies which Bots.Business account receives the verification bot.

Request Verification Bot

POST https://api.zadosource.store/v1/email/bb/verify-email

Creates a verification request and sends a verification bot to the user's Bots.Business email account.

Authentication

Required (X-API-Key)

Headers

Header	Value
`Content-Type`	`application/json`
`X-API-Key`	`your_api_key_here`

Request Body

Field	Type	Required	Description
`email`	string	Yes	Email address associated with Bots.Business account
`expiry_minutes`	integer	No	OTP expiry time (1-30 minutes, default: 5)

{
  "email": "[email protected]",
  "expiry_minutes": 10
}

Success Response

{
    "success": true,
    "message": "Verification bot successfully sent to your Bots.Business account.",
    "data": {
        "RequestId": "req_a1b2c3d4e5f67890",
        "BotId": 12345,
        "ExpiresInSeconds": 600,
        "ExpiresInMinutes": 10,
        "RequestedAt": "2024-01-15T10:30:00+00:00",
        "Email": "[email protected]"
    }
}

Error Responses

HTTP Code	Message
400	Valid email address is required
401	Invalid or inactive API key
403	This email has been blocked from receiving OTPs
409	You already have an active verification request
429	Rate limit exceeded (100/hour per API key)
503	Service temporarily unavailable

Check Email Status

POST https://api.zadosource.store/v1/email/bb/check-email

Get current verification status, block status, and active request details for an email address.

Authentication

Required (X-API-Key)

Headers

Header	Value
`Content-Type`	`application/json`
`X-API-Key`	`your_api_key_here`

Request Body

Field	Type	Required	Description
`email`	string	Yes	Email address to check

{
  "email": "[email protected]"
}

Success Response

{
    "success": true,
    "data": {
        "Email": "[email protected]",
        "IsBlocked": false,
        "IsVerified": false,
        "HasActiveRequest": true,
        "ActiveRequest": {
            "RequestId": "req_a1b2c3d4e5f67890",
            "ExpiresAt": "2024-01-15T10:40:00+00:00",
            "ExpiresInSeconds": 540,
            "BotId": 12345
        }
    }
}

Error Responses

HTTP Code	Message
400	Valid email address is required
401	Invalid or inactive API key
405	Method not allowed. Use POST.

Verify OTP Code

POST https://api.zadosource.store/v1/email/bb/verify-otp

Validates the OTP code from the verification bot to confirm email ownership.

Authentication

Required (X-API-Key)

Headers

Header	Value
`Content-Type`	`application/json`
`X-API-Key`	`your_api_key_here`

Request Body

Field	Type	Required	Description
`request_id`	string	Yes	Request ID from verify-email response
`otp`	string	Yes	6-digit OTP code from bot Commands section

{
  "request_id": "req_a1b2c3d4e5f67890",
  "otp": "123456"
}

Success Response

{
    "success": true,
    "message": "Email verified successfully.",
    "data": {
        "RequestId": "req_a1b2c3d4e5f67890",
        "Email": "[email protected]",
        "VerifiedAt": "2024-01-15T10:32:00+00:00"
    }
}

Error Responses

HTTP Code	Message
400	Request ID and OTP code are required / Invalid OTP code / OTP has expired
401	Invalid or inactive API key
403	This email has been blocked
404	Verification request not found or has expired