Email Verification

Complete email address verification by submitting the code sent to your registered email. Email verification confirms that you have access to the email address associated with your account, enabling important features like booking receipts, password recovery, and account notifications.

The verification process works as follows:

1. After registration, a verification email is automatically sent to your address
2. Open the email and copy the verification code
3. Submit the code using this endpoint to verify your email
4. If the email doesn't arrive, check your spam folder or request a new one

Having a verified email address ensures you receive important communications about your bookings, account security alerts, and promotional offers from the agency.

Verify Email

Submit the verification code received via email to complete email verification.

Endpoint

INFO

POST /api/v1/client/verification/verify-email

Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer {token}	Yes
X-Agency-Signature	{signature}	Yes

Request Body

Parameter	Type	Required	Description
code	string	Yes	Verification code from email

Example Request

curl -X POST https://api.daakey.com/api/v1/client/verification/verify-email \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Agency-Signature: {signature}" \
  -d '{
    "code": "abc123"
  }'

Success Response (200)

{
  "success": true,
  "message": "Email verified successfully",
  "data": {
    "email": "john@example.com",
    "verified_at": "2024-01-15T10:00:00Z"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error Response (422)

{
  "success": false,
  "message": "Invalid verification code",
  "errors": {
    "code": ["The verification code is invalid or expired."]
  },
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

---

Resend Email Verification

Request a new verification email.

Endpoint

INFO

POST /api/v1/client/verification/resend-email

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes
X-Agency-Signature	{signature}	Yes

Example Request

curl -X POST https://api.daakey.com/api/v1/client/verification/resend-email \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Agency-Signature: {signature}"

Success Response (200)

{
  "success": true,
  "message": "Verification email sent",
  "data": {
    "email": "john@example.com"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error Response (429)

{
  "success": false,
  "message": "Too many requests",
  "data": {
    "retry_after": 60
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Notes

• Verification links expire after 24 hours
• Maximum 3 resend attempts per hour
• Email must be unique per agency