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

🟢200Success

application/json

Bodyapplication/json

🟠400Validation Error

🟠404User Not Found

🟠409Account Already Verified

🟠400Invalid or Expired Token

🟠429Rate Limit Exceeded

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '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.",
    "data": {
        "access_token": "c9085117c25f82b372d2a0e2a72e6e2b3183daa88536714489c4bc8550f76924",
        "user": {
            "id": "97bea3290b452b5e1360fed21612690b47713e32",
            "name": "Albert Daugherty",
            "email": "lazaro96@hotmail.com",
            "profile_picture": null,
            "account_status": "active",
            "email_verified": true,
            "email_verified_at": "2026-05-16T23:02:54.327Z",
            "last_login_geolocation": {
                "country_code": "SM",
                "country": "Solomon Islands",
                "region": "Roweport",
                "city": "Gulgowskifield",
                "latitude": 72.5317,
                "longitude": -77.8844,
                "timezone": "Asia/Kuala_Lumpur"
            },
            "created_at": "2026-05-16T23:02:54.329Z",
            "updated_at": "2026-05-16T23:02:54.329Z",
            "deleted_at": null
        }
    }
}

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

Resend verification code