Error Code Reference

EMTITHAL returns bilingual error envelopes for all 4xx/5xx responses. Every error carries both an Arabic and English message. There are 42 error codes.

Response Envelope Format 

// Example 401 response (Accept-Language: ar)
{
  "error_code": "AUTH.INVALID_TOKEN",
  "message_ar": "رمز الوصول غير صالح أو منتهي الصلاحية",
  "message_en": "Access token is invalid or expired",
  "request_id": "01J3...",
  "retryable": false,
  "details": null
}

Authentication

Error Code Message
AUTH.ACCOUNT_INACTIVEAccount is inactive. Please contact support
AUTH.EMAIL_ALREADY_REGISTEREDAn account with this email already exists
AUTH.EMAIL_NOT_VERIFIEDEmail address must be verified before logging in
AUTH.INVALID_CREDENTIALSEmail or password is incorrect
AUTH.INVALID_OTPInvalid or expired OTP
AUTH.INVALID_TOKENAccess token is invalid or expired
AUTH.MISSING_TOKENAuthorization header with Bearer token is required
AUTH.SESSION_EXPIREDYour session has expired. Please log in again

Billing

Error Code Message
BILLING.INVOICE_NOT_FOUNDInvoice not found
BILLING.PAYMENT_FAILEDPayment failed. Please check your payment details and try again
BILLING.PLAN_NOT_FOUNDRequested subscription plan not found
BILLING.SUBSCRIPTION_NOT_FOUNDNo active subscription found for this account

Jobs

Error Code Message
JOB.DOCUMENT_NOT_IN_PROJECTOne or more documents do not belong to this project
JOB.NOT_CANCELLABLEJob cannot be cancelled in its current state
JOB.NOT_FOUNDCompliance job not found
JOB.NO_ACTIVE_SUBSCRIPTIONNo active subscription found for this account. Please select a plan to get started
JOB.NO_CODES_SPECIFIEDAt least one design code must be specified
JOB.PROJECT_NOT_FOUNDProject not found or does not belong to this user
JOB.QUOTA_EXCEEDEDYour plan's compliance-review quota or credit ceiling has been reached
JOB.RESULT_PDF_NOT_READYCompliance report PDF has not been generated yet
JOB.UNKNOWN_DESIGN_CODESUnknown design codes in request
JOB.VERDICT_MISMATCHVerdict status conflict
JOB.VERDICT_NOT_FOUNDNo verdict found for the specified rule in this job

Payload

Error Code Message
PAYLOAD_TOO_LARGERequest body exceeds the maximum allowed size

Rate Limiting

Error Code Message
RATE_LIMIT.EXCEEDEDYou have exceeded the request rate limit. Please retry after the specified delay

Rule Review

Error Code Message
RULE.CITATION_NOT_FOUND_IN_SOURCEReferenced citation not found in source document
RULE.MANIFEST_VALIDATION_ERRORRule manifest validation failed
RULE.MINI_ENGINE_INCONSISTENCYInternal processing engine inconsistency detected
RULE.PDF_FILE_MISSINGRequested PDF file not found
RULE.PLAUSIBILITY_VIOLATIONRule data violates plausibility constraints
RULE.QUEUE_ITEM_NOT_FOUNDReview queue item not found
RULE.QUEUE_ITEM_NOT_PENDINGReview queue item is not in pending status

Server

Error Code Message
SERVER.INTERNAL_ERRORAn unexpected internal error occurred. The incident has been logged
SERVER.SERVICE_UNAVAILABLEService is temporarily unavailable. Please try again later
SERVER.TEMPORAL_UNAVAILABLEWorkflow service is temporarily unavailable. Please try again later

Validation

Error Code Message
VALIDATION.FIELD_INVALIDRequest data is invalid. Please review the indicated fields
VALIDATION.INVALID_EMAILInvalid email address format
VALIDATION.MISSING_FIELDA required field is missing
VALIDATION.STRING_TOO_LONGField value exceeds the maximum allowed length
VALIDATION.STRING_TOO_SHORTField value is shorter than the minimum allowed length

Webhooks

Error Code Message
WEBHOOK.PARSE_ERRORWebhook payload could not be parsed
WEBHOOK.SIGNATURE_INVALIDWebhook signature verification failed