Verify email address

Developing

POST

/auth/verify-email

Confirms a user’s email address by validating the verification code sent during the registration process. When the correct and unexpired code is provided, the system marks the email as verified and activates the account, allowing the user to access authentication features such as login.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200Email Verified

application/json

Body

🟠400Validation Error

🟠404User Not Found

🟠409Email Already Verified

🟠400Invalid or Expired Token

🟠429Rate Limit Exceeded

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:3000/api/v1/auth/verify-email' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "koby.skiles@hotmail.com",
    "token": "104625"
}'

Response Example

200 - Example

{
    "status": "success",
    "message": "User verified successfully.",
    "access_token": "76fef74653439708fba408eefc24c68267a75dec5a636656ae4cd399aa051017",
    "data": {
        "id": "7a922ea98b22cb8e5805e89eccd0c19103217e53",
        "name": "Jeanette Tromp",
        "email": "jamaal.gerlach@hotmail.com",
        "profile_picture": "https://avatars.githubusercontent.com/u/33665106",
        "account_status": "active",
        "email_verified": true,
        "email_verified_at": "2026-03-08T04:07:27.458Z",
        "last_login_geolocation": {
            "country_code": "GE",
            "country": "Spain",
            "region": "North Anthony",
            "city": "New Freddy",
            "latitude": 0.5739,
            "longitude": -170.7089,
            "timezone": "America/Argentina/Buenos_Aires"
        },
        "created_at": "2026-03-08T04:07:27.459Z",
        "updated_at": "2026-03-08T04:07:27.459Z",
        "deleted_at": null
    }
}

Modified at 2026-03-07 00:38:12

Resend verification code