This endpoint implements OAuth 2.0 Client Credentials flow for machine-to-machine authentication. Upon successful authentication, a JWT token is returned which must be included in the Authorization header of all subsequent API requests.

Verifies whether the provided mobile numbers are registered and active in the system. This endpoint requires Bearer (JWT) authentication obtained from /auth/authenticate.

Behavior:

• Normalizes input mobile numbers to digits-only form (removes leading +, 00 or local 0).
• Performs a single batch check and returns two lists: foundNumbers and notFoundNumbers.

Limits & validation:

• Maximum 100 mobile numbers per request.
• mobileNumbers cannot be null or empty.
• Mobile number format validated by the API validator; validation failures return VALIDATION_ERROR.

Common error codes: INVALID_PAYLOAD, EMPTY_MOBILE_NUMBERS, MAX_ITEMS_EXCEEDED, VALIDATION_ERROR, MOBILE_NUMBERS_NOT_FOUND, DB_VERIFICATION_ERROR.

Retrieves all delivery addresses and customer delivery preferences for the specified mobile numbers. This endpoint requires Bearer (JWT) authentication obtained from /auth/authenticate.

Behavior:

• Normalizes input mobile numbers to digits-only form (removes leading +, 00 or local 0).
• Returns a dictionary mapping each mobile number to an array of Address objects.
• Each address includes coordinates, building and apartment details, address label and delivery preferences.

Limits & validation:

• Maximum 100 mobile numbers per request.
• mobileNumbers cannot be null or empty.
• Mobile number format validated by the API validator; validation failures return VALIDATION_ERROR.

Common error codes: INVALID_PAYLOAD, EMPTY_MOBILE_NUMBERS, MAX_ITEMS_EXCEEDED, VALIDATION_ERROR, ADDRESSES_NOT_FOUND, DB_REACH_ERROR.

Sends a notification to the user using their Emirates Id or phone number. This endpoint requires Bearer (JWT) authentication obtained from /auth/authenticate.

Behavior & rules:

• Request must include from, to, subject and at least one of text or html.
• Recipient (to) can be any special receiver codes (trade license tr..., contract ca..., phone number of 12 digits, Emirates ID 784 + 12 digits, or ERN of 19 alphanumeric characters). Invalid formats return INVALID_RECIPIENT_ADDRESS.
• Attachments are provided as public URLs; up to 5 attachments are allowed and each must be <= 10MB.

Validation & errors:

• Attachment entries require filename and a valid HTTP/HTTPS url.
• Common error codes: INVALID_PAYLOAD, VALIDATION_ERROR, SENDER_NOT_ALLOWED, RECEIVER_DOMAIN_NOT_ALLOWED, INVALID_RECIPIENT_ADDRESS, EMAIL_SEND_FAILED, SENDER_VALIDATION_ERROR, EMAIL_SEND_ERROR.

On success the endpoint returns a confirmation including to, subject and an eventId for the published email event.