Veeam Backup & Replication 13
REST API Reference
Related documents

Backup Objects

The Backup Objects section defines operations for managing backup objects — VMs and vApps that are included in backups created by the backup server.

Types of backup objects differ depending on the backup job platform:

  • Backups of VMware vSphere jobs contain VMs only.
  • Backups of VMware Cloud Director jobs contain VMs and vApps.

Get All Backup Objects

The HTTP GET request to the /api/v1/backupObjects endpoint gets an array of virtual infrastructure objects (VMs and VM containers) that are included in backups created by the backup server.

Available to: Backup Administrator, Backup Operator, Restore Operator, Backup Viewer, Security Administrator. Also available to custom roles that have backup or restore permissions.

SecurityBearer
Request
query Parameters
skip
integer <int32>

Number of backup objects to skip.

limit
integer <int32>
Default: 200

Maximum number of backup objects to return.

orderColumn
string (EBackupObjectsFiltersOrderColumn)

Sorts backup objects by one of the backup object parameters.

Enum: "Name" "ObjectId" "PlatformId" "Type"
orderAsc
boolean

If true, sorts backup objects in ascending order by the orderColumn parameter.

nameFilter
string

Filters backup objects by the nameFilter pattern. The pattern can match any backup object parameter. To substitute one or more characters, use the asterisk (*) character at the beginning and/or at the end.

platformNameFilter
string (EPlatformType)

Filters backup objects by platform name.

Enum: "VMware" "HyperV" "CloudDirector" "WindowsPhysical" "LinuxPhysical" "Tape" "CustomPlatform" "EntraID" "UnstructuredData" "Test" "MongoDb" "Iris" "AWSEC2" "AzureCompute" "GCE" "Nutanix" "Proxmox" "LinuxPhysicalPpc" "ApplicationBackupRepository"
platformIdFilter
string <uuid>

Filters backup objects by platform ID.

typeFilter
string

Filters backup objects by object type.

viTypeFilter
string

Filters backup objects by the type of VMware vSphere server.

header Parameters
x-api-version
required
string
Default: 1.3-rev2

Version and revision of the client REST API. Must be in the following format: <version>-<revision>.

Responses
200

OK

401

Unauthorized. The authorization header has been expected but not found (or found but is expired).

403

Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.

404

Not found. No object was found with the path parameter specified in the request.

500

Internal server error. The request has been received but could not be completed because of an internal error at the server side.

get/api/v1/backupObjects
Request samples 
Response samples 
application/json
{
  • "data": [
    ],
  • "pagination": {
    }
}
Get Backup Object
The HTTP GET request to the /api/v1/backupObjects/{id} endpoint gets a backup object that has the specified id. 
Available to: Backup Administrator, Backup Operator, Restore Operator, Backup Viewer, Security Administrator. Also available to custom roles that have backup or restore permissions.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
Backup object ID. To get the ID, run the Get All Backup Objects request.


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


500
Internal server error. The request has been received but could not be completed because of an internal error at the server side.


get/api/v1/backupObjects/{id}
Request samples 
Response samples 
application/json
{
  • "viType": "VirtualMachine",
  • "objectId": "vm-69191",
  • "path": "vcenter01.tech.local\\Atlanta\\esx04.tech.local\\Enterprise\\winsrv88",
  • "platformName": "VMware",
  • "backupId": "d0323af1-0fcc-4e80-b3a0-76f10234d494",
  • "id": "fcea73fa-aa48-45e1-89e4-6e33411e8de2",
  • "name": "winsrv88",
  • "type": "VM",
  • "platformId": "00000000-0000-0000-0000-000000000000",
  • "restorePointsCount": 13,
  • "size": 53687091200
}
Create Recovery Media Task for Backup Object
The HTTP POST request to the /api/v1/backupObjects/{id}/createRecoveryMedia endpoint starts an asynchronous task that creates Veeam Recovery Media for a backup created by Veeam Agent for Microsoft Windows. The endpoint returns a task that you can poll through the Get Task request to track progress and surface failures. To download the resulting ISO file once the task completes successfully, run the Download Recovery Media request. 
Available to: Backup Administrator, Restore Operator. Also available to custom roles that have restore permissions.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
Backup object ID. To get the ID, run the Get All Backup Objects request.


 
query Parameters
format
required
string (ERecoveryMediaFormat) 
Recovery media format.


 Value: "Iso"  
allowRemoteBmr
required
boolean
Enables the ability to perform Bare Metal Recovery remotely from the backup server when this recovery media is booted


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
201
A RecoveryMedia task has been started. To check the progress, track the task state.


400
Bad request. This error is related to POST/PUT requests. The request body is malformed, incomplete or otherwise invalid.


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


500
Internal server error. The request has been received but could not be completed because of an internal error at the server side.


post/api/v1/backupObjects/{id}/createRecoveryMedia
Request samples 
Response samples 
application/json
{
  • "type": "Common",
  • "id": "c3d4e5f6-7a8b-49c0-8d1e-2f3a4b5c6d7e",
  • "name": "Rescan repository task",
  • "state": "Working",
  • "progressPercent": 45,
  • "creationTime": "2026-05-20T10:30:00Z",
  • "endTime": "2026-05-20T10:42:00Z",
  • "result": "None"
}
Create Recovery Media for Backup ObjectDeprecated
The HTTP GET request to the /api/v1/backupObjects/{id}/createRecoveryMedia endpoint creates Veeam Recovery Media for a backup created by Veeam Agent for Microsoft Windows. The request will create an ISO file that you can boot from in case the computer stops working or the hard disk fails.
 You can also create Veeam Recovery Media for a computer in a protection group. For more information, see Create Recovery Media for Discovered Entity. 
Deprecated: this synchronous endpoint blocks while the ISO is being created and returns a generic HTTP 500 on failure. Use the Create Recovery Media Task for Backup Object request followed by the Download Recovery Media request instead.
Available to: Backup Administrator, Restore Operator. Also available to custom roles that have restore permissions.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
Backup object ID. To get the ID, run the Get All Backup Objects request.


 
query Parameters
format
required
string (ERecoveryMediaFormat) 
Recovery media format.


 Value: "Iso"  
allowRemoteBmr
required
boolean
Enables the ability to perform Bare Metal Recovery remotely from the backup server when this recovery media is booted


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


400
Bad request. This error is related to POST/PUT requests. The request body is malformed, incomplete or otherwise invalid.


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


500
Internal server error. The request has been received but could not be completed because of an internal error at the server side.


get/api/v1/backupObjects/{id}/createRecoveryMedia
Request samples 
Response samples 
application/json
{
  • "errorCode": "UnexpectedContent",
  • "message": "One or more request parameters are not valid."
}
Get Restore Points
The HTTP GET request to the /api/v1/backupObjects/{id}/restorePoints endpoint gets an array of restore points of a backup object that has the specified id.
Available to: Backup Administrator, Backup Operator, Restore Operator, Backup Viewer. Also available to custom roles that have backup or restore permissions.


SecurityBearer 
Request 
path Parameters
id
required
string <uuid> 
Backup object ID. To get the ID, run the Get All Backup Objects request.


 
query Parameters
skip
integer <int32> 
Number of restore points to skip.


 
limit
integer <int32> 
 Default:  200
Maximum number of restore points to return.


 
orderColumn
string (EObjectRestorePointsFiltersOrderColumn) 
Sorts restore points by one of the restore point parameters.


 Enum: "CreationTime" "PlatformId" "BackupId"  
orderAsc
boolean
If true, sorts restore points in ascending order by the orderColumn parameter.


 
createdAfterFilter
string <date-time> 
Returns restore points that are created after the specified date and time.


 
createdBeforeFilter
string <date-time> 
Returns restore points that are created before the specified date and time.


 
nameFilter
string
Filters restore points by the nameFilter pattern. The pattern can match any restore point parameter. To substitute one or more characters, use the asterisk (*) character at the beginning and/or at the end.


 
platformNameFilter
string (EPlatformType) 
Filters restore points by the platform name of the backup object.


 Enum: "VMware" "HyperV" "CloudDirector" "WindowsPhysical" "LinuxPhysical" "Tape" "CustomPlatform" "EntraID" "UnstructuredData" "Test" "MongoDb" "Iris" "AWSEC2" "AzureCompute" "GCE" "Nutanix" "Proxmox" "LinuxPhysicalPpc" "ApplicationBackupRepository"  
platformIdFilter
string <uuid> 
Filters restore points by ID of the backup object platform.


 
backupIdFilter
string <uuid> 
Filters restore points by backup ID.


 
backupObjectIdFilter
string <uuid> 
Filters restore points by backup object ID.


 
malwareStatusFilter
Array of strings (ESuspiciousActivitySeverity) 
Filters restore points by malware status.


Items Enum: "Clean" "Suspicious" "Infected" "Informative"  
typeFilter
Array of strings (ERestorePointType) 
Filters restore points by restore point type.


Items Enum: "Increment" "Full" "Rollback" "Snapshot" "Cdp" "Different"  
excludeSnapshotTypeFilter
Array of integers <int32> 
Excludes restore points whose snapshot type matches any of the specified values.


 
header Parameters
x-api-version
required
string
 Default:  1.3-rev2
Version and revision of the client REST API. Must be in the following format: <version>-<revision>.


 
Responses 
200
OK


401
Unauthorized. The authorization header has been expected but not found (or found but is expired).


403
Forbidden. The user sending the request does not have adequate privileges to access one or more objects specified in the request.


404
Not found. No object was found with the path parameter specified in the request.


500
Internal server error. The request has been received but could not be completed because of an internal error at the server side.


get/api/v1/backupObjects/{id}/restorePoints
Request samples 
Response samples 
application/json
{
  • "data": [
    ],
  • "pagination": {
    }
}