Get history

Description

Get the history of a monitoring check


 Parameters

Name Data Type Status Description
auth-id or sub-auth-id or sub-auth-user Integer Required Authentication parameter
auth-password String Required Authentication parameter
id Integer Required The ID of the monitoring check
page Integer  Required Page number starting from 1. 
rows-per-page Integer  Required Results per page. Can be 10, 20, 30, 50, or 100. 
location-id Integer  Optional If you want to see the history only from a specific location. You can see the ids of all of the locations by using this API method List all DNS Failover and Monitoring nodes
status Integer Optional

Possible values:

  • -1 - UNKNOWN
  •  0 - DOWN
  •  1 - UP

Return: The history of a specific check.


Errors

When the authentication of the API user is not correct, any API request will fail with the following status and statusDescription:

{"status":"Failed","statusDescription":"Invalid authentication, incorrect auth-id or auth-password."}

If the entered ID of the monitoring check is invalid, the following status will be returned:

{"status":"Failed","statusDescription":"Invalid id param."}

If there is no value for "page", the following status will be returned:

{"status":"Failed","statusDescription":"Missing required parameter 'page'"}

If there is no value for "rows-per-page", the following status will be returned:

{"status":"Failed","statusDescription":"Wrong or missing required parameter 'rows-per-page'."}

Note: These are example errors in JSON format, and these are not the only errors that can be displayed.


 Example

URL JSON: https://api.cloudns.net/monitoring/get-history.json
POST/GET:
auth-id=0&auth-password=password&id=12&page=1&rows-per-page=10
sub-auth-id=0&auth-password=password&id=12&page=1&rows-per-page=10

URL XML: https://api.cloudns.net/monitoring/get-history.xml
POST/GET:
auth-id=0&auth-password=password&id=12&page=1&rows-per-page=10
sub-auth-id=0&auth-password=password&id=12&page=1&rows-per-page=10


Last modified: 2025-06-03
Cookies help us deliver our services. By using our services, you agree to our use of cookies. Learn more