Initiates the passwordless authentication flow by requesting a one-time token for the provided identity. Use this endpoint before token verification to start a secure login session.

Validates the token generated during passwordless login and confirms user authentication. Returns the verification result that can be used to continue protected account flows.

Enables or disables PO Box auto-renewal for an authenticated customer and box reference. Stores the latest auto-renew preference and returns a renewal update outcome.

Processes CRM approval or rejection for a pending agent profile linked to a PO Box. Captures approval remarks and updates downstream status used by renewal/rental journeys.

Handles CRM decisioning for pending rental requests submitted for PO Box services. Applies approval status and remarks so the request can proceed or be rejected.

Confirms payment completion for guest renewal transactions using a payment reference. Finalizes renewal payment status and returns payment details for client follow-up.

Retrieves renewal eligibility, subscription context, and customer data for guest users. Supports renewal, upgrade, and subscription-change scenarios before pricing or save.

Returns available renewed-by options for guest renewal submissions. Use this list to populate UI selections before posting renewal save requests.

Calculates guest renewal charges based on box details, expiry, bundle changes, and options. Provides a pricing breakdown that should be reviewed before creating payment orders.

Creates or updates guest renewal order details prior to payment confirmation. Persists the renewal payload and returns order-level response data for checkout steps.

Publishes guest renewal notification events for business and customer communication flows. Supports operational messaging and payment history/event propagation.

Fetches issuing entities used for Escher guest trade-license validation journeys. Provides lookup values required in guest corporate renewal and onboarding forms.

Updates auto-renew preference for guest/Escher scenarios with additional transaction context. Includes last tenure and order references required by guest renewal integration rules.

Retrieves Ministry of Economy entity records using the provided entity code. Used to prefill or validate corporate profile information in rental and renewal flows.

Looks up MOE entity and owner details using entity code and trade license number. Supports license verification and corporate customer validation workflows.

Returns the master list of MOE issuing entities. Use this endpoint for dropdowns and validation in corporate license-related forms.

Cancels a previously created PO Box renewal request by identifier. Typically used after validation/verification steps in the renewal cancellation flow.

Fetches existing renewal agent details associated with the supplied agent identifier. Supports edit and review workflows before update, payment, or deletion operations.

Processes payment status for renewal agent-related transactions. Uses payment references to reconcile and return final payment execution results.

Processes payment for Tijari (corporate) renewal transactions. Returns payment completion state and details required by post-payment handling.

Creates agent renewal records and optionally prepares payment order information. Accepts agent profile and payment properties to continue the renewal journey.

Saves Tijari corporate renewal data, including company/license details and amounts. Used before corporate payment processing and CRM approval checkpoints.

Updates an existing renewal agent record, including identity and attachment details. Keeps agent information synchronized before approval and payment processing.

Validates whether a PO Box renewal can be cancelled and issues a verification reference. Acts as the first step of the OTP-based cancellation confirmation flow.

Verifies the OTP/reference for cancellation and confirms cancellation authorization. Completes the validation flow before final cancellation actions are executed.

Retrieves additional renewal service details tied to box and emirate context. Used to display optional services and supplementary renewal information.

Confirms payment outcome for a submitted address-change request. Updates payment state using the path payment reference number.

Confirms payment outcome for a submitted lock-change request. Finalizes lock-change payment status for downstream fulfillment.

Returns detailed PO Box renewal data for authenticated renewal scenarios. Includes box, subscription, customer, and related context required by renewal UI.

Lists additional optional services available for a selected renewal bundle. Supports add-on selection before pricing and order submission.

Calculates charges for selected additional renewal service types. Returns total amount and per-service pricing details for transparent billing.

Creates an address-change order for a specific PO Box and customer context. Stores delivery/address data and prepares payment metadata when applicable.

Creates a lock-change request and returns order/payment initiation details. Used to start lock replacement workflows before payment confirmation.

Confirms payment for standard PO Box renewal orders. Finalizes renewal transaction status and returns payment/transaction metadata.

Returns the allowed renewed-by values for standard renewal flow. Use this lookup to validate and populate renewal ownership selections.

Calculates standard renewal pricing based on bundle, dates, and optional changes. Provides detailed service-level pricing and discount-adjusted totals.

Saves standard PO Box renewal payload and creates/updates renewal order data. Returns order references and payment gateway details when payment is needed.

Calculates add-on charges for guest renewal-specific additional service requests. Returns amount breakdowns aligned with guest renewal pricing rules.

Returns available rental bundles and package information for PO Box rental journeys. Use this endpoint as the entry point for bundle selection in rental flow.

Retrieves allowed expiry date options for a selected rental bundle. Supports date pickers and tenure constraints during new rental creation.

Returns available unassigned PO Boxes filtered by bundle, location, and reseller context. Can also consider hold references when continuing partially completed rentals.

Fetches eligible PO Box office/location options for the selected bundle and emirate. Used to drive location selection before box reservation.

Retrieves previously rejected corporate box details for correction/resubmission. Helps clients repopulate and amend rejected rental submissions.

Returns renewal details in rental context, including upgrade-only and bundle-change options. Used when transitioning an existing rental into a renewal decision flow.

Saves complete PO Box rental request data including profiles, services, and payment setup. Creates order context for subsequent payment and confirmation steps.