WHM API: restore_queue_list_completed does not show restores performed with restorepkg

imorandin

• June 08, 2026 19:54

Hi,

I'm trying to retrieve a complete history of account restores via the WHM API.

The problem is that whmapi1 restore_queue_list_completed only seems to return restore jobs initiated through the Backup Restoration system (backuprestore), but it does not include restores performed using restorepkg.

For example, in WHM → Review Transfers and Restores, I can see both types of restore sessions:

• backuprestore
• restorepkg

However, the API only returns the backuprestore entries:

Example output (account names obfuscated):

# whmapi1 restore_queue_list_completed

---
data:
  restore_job:
    -
      restore_job:
        restore_point: 2026-06-04
        user: account_example
      status_info:
        transfer_session_id: serverbackup20260604181217ABC
        status: 0
        statusmsg: The subprocess ended prematurely because it received the "KILL" (9) signal.

    -
      restore_job:
        restore_point: 2026-06-04
        user: account_example
      status_info:
        transfer_session_id: serverbackup20260604190454DEF
        status: 0
        statusmsg: Account Restore Failed...
metadata:
  command: restore_queue_list_completed
  result: 1

Meanwhile, WHM shows additional completed restore sessions initiated by restorepkg, but those sessions are not returned by the API.

Is there another API endpoint that provides the same information shown in WHM → Review Transfers and Restores, including both backuprestore and restorepkg sessions?

Or is this a limitation/bug in restore_queue_list_completed?

Thanks.

• 

  cPRex Jurassic Moderator

  • June 09, 2026 18:07

  Hey there!  Thanks for bringing this up - I confirmed the issue and also didn't find a workaround to show them all on my end either.

  After speaking with the developers I've created case CPANEL-53908 to see if this behavior can be improved to show all the restoration activity on the server with the API call.

  I've linked this thread to that case so if I hear any updates on my end I'll be sure to post!

  0

Please sign in to leave a comment.