Restore Points

The /RestorePoints resource collection represents restore points created by Veeam Backup for Microsoft 365.

Get Restore Points

Returns a collection of restore points created by Veeam Backup for Microsoft 365.

SecurityBearer
Request
query Parameters
organizationId
string <uuid>

Specifies the identification number of the Microsoft 365 organization. For more information on how to get this parameter, see Get Organizations.

jobId
string <uuid>

Specifies the identification number of the backup job that created the restore points you want to get. For more information on how to get this parameter, see Get Backup Jobs.

repositoryId
string <uuid>

Specifies the identification number of the backup repository where the restore point was created. For more information on how to get this parameter, see Get Backup Repositories.

from
string <date-time>

Specifies the date and time. The server will return information about restore points that were created after the specified date and time.

to
string <date-time>

Specifies the date and time. The server will return information about restore points that were created before the specified date and time.

orderAsc
boolean

Defines whether the date and time are specified in ascending order.

isLongTermCopy
boolean

Defines whether the server will return information about restore points created by backup copy jobs in the following object storage repositories: Azure Blob Storage Archive access tier, Amazon S3 Glacier Instant Retrieval, Amazon S3 Glacier Flexible Retrieval or Amazon S3 Glacier Deep Archive storage classes.

isCopy
boolean

Defines whether the server will return information about restore points created by backup copy jobs in all object storage repositories.

isRetrieved
boolean

Defines whether the server will return information about restore points retrieved from object storage repositories by data retrieval jobs.

userId
string

Specifies the identification number of the user. For more information on how to get this parameter, see Get Organization Users.

groupId
string

Specifies the identification number of the group. For more information on how to get this parameter, see Get Organization Groups.

siteId
string

Specifies the identification number of the SharePoint site. For more information on how to get this parameter, see Get SharePoint Sites.

teamId
string <uuid>

Specifies the identification number of the team. For more information on how to get this parameter, see Get Teams.

limit
integer <int32>

Limits the maximum number of items that the server will return on a page. The maximum supported number of items per page is 10,000. The default value is 30.

offset
integer <int32>

Excludes from a response page the first N items of a collection resource. The default value is 0.

Responses
200

OK

default

Operation failure response.

get/v8/RestorePoints
Request samples
Response samples
application/json
{
  • "offset": 0,
  • "limit": 0,
  • "setId": "83e19bc1-5428-42b5-88ea-b28354e481f3",
  • "results": [
    ],
  • "_links": {
    }
}

Get Restore Point

Returns a resource representation of a restore point with the specified ID.

SecurityBearer
Request
path Parameters
restorePointId
required
string

Specifies the identification number of the restore point. For more information on how to get this parameter, see Get Restore Points.

Responses
200

OK

default

Operation failure response.

get/v8/RestorePoints/{restorePointId}
Request samples
Response samples
application/json
{
  • "id": "string",
  • "isDeleted": true,
  • "repositoryId": "00000000-0000-0000-0000-000000000000",
  • "backupTime": "2019-08-24T14:15:22Z",
  • "jobId": "00000000-0000-0000-0000-000000000000",
  • "retrievalId": "00000000-0000-0000-0000-000000000000",
  • "organizationId": "00000000-0000-0000-0000-000000000000",
  • "isExchange": true,
  • "isSharePoint": true,
  • "isOneDrive": true,
  • "isTeams": true,
  • "isLongTermCopy": true,
  • "isCopy": true,
  • "isRetrieved": true,
  • "eTag": 0,
  • "objectsEtag": 0,
  • "immutabilityExpiresOn": "2019-08-24T14:15:22Z",
  • "_links": {
    }
}

Document updated 12/18/2025

Page content applies to build 8.3.0.2201