Get Data Backup History
Purpose
To fetch information about the recent data backups scheduled for your Zoho CRM account over the past year.
Endpoints
- GET /backup/history
Request Details
Request URL
{api-domain}/crm/bulk/{version}/backup/history
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
ZohoCRM.bulk.backup.ALL
(or)
ZohoCRM.bulk.backup.READ
Possible operation types
ALL - Full access to backup data
READ - Fetch information about a scheduled backup
Parameters
- pageinteger, optional
Specify the page number to retrieve records from. Default value is 1.
Possible values: Positive Integer values only. - per_pageinteger, optional
Specifies the number of records to return per page. The default and the maximum possible value is 200.
Possible values: Positive Integer values only.
Note
Backup history for the past one year is available. Backup history older than one year is not available.
Copiedcurl "https://www.zohoapis.com/crm/bulk/v8/backup/history"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Response JSON
- historyJSON array
An array of objects, each representing a scheduled backup.
- idstring
The ID of the scheduled backup job.
- done_byJSON object
Details of the user who scheduled the backup. The details include the name, record ID, and the ZUID of the user.
- log_timeDateTime
The date and time at which the backup was scheduled. This key is null if you do not specify the rrule while scheduling the backup.
- statestring
Represents the completion status of the scheduled backup. The possible values are completed, failure and null. Null value is returned when the backup is in progress or in scheduled state.
- actionstring
Represents the action taken for the scheduled backup. The possible values are scheduled, stopped, purchased and null. Null value is returned if the status is completed or failed.
- repeat_typestring
Represents the repeat type for the scheduled backup. The possible values are immediate, weekly, biweekly and monthly.
- file_namestring
The name of the ZIP file available for download, if applicable. This will be null if no file is generated.
- countinteger
Represents any additional purchased backup count for the customer.
Note
If no backups were scheduled in the past one year, the system responds with a No content body with status code 204.
Possible Errors
- NO_CONTENTHTTP 204
No content
Resolution: No backups were scheduled in the past one year. - INVALID_REQUEST_METHODHTTP 400
The request method is incorrect.
Resolution: Use the HTTP GET method to make this API call. Any other request method will result in this error. - OAUTH_SCOPE_MISMATCHHTTP 401
The access token you have used to make this API call does not have the required scope.
Resolution: Generate a new access token with the required scopes for this API. Refer to the Scope section at the beginning of this page for the list of required scopes. - NO_PERMISSIONHTTP 403
Permission denied to read
Resolution: The user does not have permission to read data backup history data. Contact your system administrator. - INVALID_URL_PATTERNHTTP 404
The request URL is incorrect.
Resolution: Specify a valid request URL. Refer to the request URL section at the beginning of this page for more details. - INTERNAL_ERRORHTTP 500
Unexpected and unhandled exception in the server.
Resolution: Contact the support team at support@zohocrm.com.
Sample Response
Copied{
"history": [
{
"id": "4876876000001758001",
"done_by": {
"id": "4876876000000327001",
"name": "Patricia Boyle",
"zuid": "756783625"
},
"log_time": "2022-07-08T13:23:05+05:30",
"state": null,
"action": "stopped",
"repeat_type": "biweekly",
"file_name": null,
"count": 0
},
{
"id": "4876876000001757002",
"done_by": {
"id": "4876876000000327001",
"name": "Patricia Boyle",
"zuid": "756783625"
},
"log_time": "2022-07-08T13:18:22+05:30",
"state": null,
"action": "scheduled",
"repeat_type": "biweekly",
"file_name": null,
"count": 0
},
{
"id": "4876876000001594002",
"done_by": {
"id": "4876876000000327001",
"name": "Patricia Boyle",
"zuid": "756783625"
},
"log_time": "2022-06-23T17:31:03+05:30",
"state": "completed",
"action": null,
"repeat_type": "immediate",
"file_name": null,
"count": 0
},
{
"id": "4876876000001593005",
"done_by": {
"id": "4876876000000327001",
"name": "Patricia Boyle",
"zuid": "756783625"
},
"log_time": "2022-06-23T17:30:51+05:30",
"state": null,
"action": "initiated",
"repeat_type": "immediate",
"file_name": null,
"count": 0
}
],
"info": {
"page": 1,
"per_page": 50,
"count": 4,
"more_records": false
}
}