AuthnAuthzAPI
  1. Authentication
  • Overview
  • Authentication
    • Register a new user
      POST
    • Verify email address
      POST
    • Resend verification code
      POST
    • Login user
      POST
  1. Authentication

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 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 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
Previous
Register a new user
Next
Resend verification code
Built with