Get history pages

Description

Get the history pages of the 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
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 how many history pages are 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 number of pages with history of the 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."}

f 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-pages.json
POST/GET:
auth-id=0&auth-password=password&id=12&rows-per-page=10
sub-auth-id=0&auth-password=password&id=12&rows-per-page=10

URL XML: https://api.cloudns.net/monitoring/get-history-pages.xml
POST/GET:
auth-id=0&auth-password=password&id=12&rows-per-page=10
sub-auth-id=0&auth-password=password&id=12&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