Poll Order Status Until Human Review Completes

Repeatedly call lexera_get_order_status with the order_id to track pending_admin_triage and verified_executed states until artifacts are ready.

After dispatching a contract with lexera_route_to_specialist, the order moves through a human verification pipeline. Use lexera_get_order_status to poll the real-time state of the document until the attorney completes review and the certified artifacts become available.

Prerequisites

• The order_id returned from a successful lexera_route_to_specialist dispatch.
• An active SSE session and a valid Bearer token.

Steps

1. Send the status request

   POST a JSON-RPC 2.0 payload to your active SSE session URL with the order_id as job_id.

   {
     "jsonrpc": "2.0",
     "id": 2,
     "method": "tools/call",
     "params": {
       "name": "lexera_get_order_status",
       "arguments": {
         "job_id": "32e65a49-ba4c-441f-b8fe-73932e545f89"
       }
     }
   }
   

   The server returns HTTP 202 Accepted. The status response streams back over the open SSE connection.

2. Interpret the response

   The response payload contains the current_status field. Lexera documents two exhaustive statuses today:

   • pending_admin_triage — The order was successfully dispatched and is awaiting human attorney review. The payload includes assigned_firm, authorized_amount, and requires_human_verification: true.
   • verified_executed — The attorney has completed review and issued the law firm-certified signature. The payload includes download URLs for the certified artifacts, attorney notes, and a completion timestamp.
3. Poll until verified_executed

   Continue calling lexera_get_order_status at reasonable intervals until current_status becomes verified_executed.

   Back off between polls to avoid unnecessary load. A practical pattern is to poll every 30 seconds for the first few minutes, then increase the interval to 2 to 5 minutes as the review may take hours depending on jurisdiction and complexity.

Completed order example

When the attorney finishes review, the streamed payload looks like this:

{
  "order_id": "32e65a49-ba4c-441f-b8fe-73932e545f89",
  "current_status": "verified_executed",
  "certified_redline_url": "https://lexera.dev/api/mcp/orders/32e65a49.../download",
  "certified_report_url": "https://lexera.dev/api/mcp/orders/32e65a49.../download",
  "attorney_notes": "Removed California law, updated to Dubai/UAE. Capped penalty.",
  "completed_at": "2026-08-24T09:15:11.356Z"
}

Next steps

• Once the status is verified_executed, download the certified .docx artifacts by following the Download Artifacts guide.
• For full parameter details, see the lexera_get_order_status reference.