CleanTalk Anti-Spam "monitoring_services_get" API method description

This method returns list of resources monitored by Uptime Monitoring service.

Request

Data JSON Example

{
  "method_name": "monitoring_services_get",
  "user_token": "your_user_token"
}

Data Processing

Necessary information about the data processing.

Parameter	Explanation
HTTP Method	GET or POST
Data format	JSON
URL	https://api.cleantalk.org

Required Parameters

These parameters are required.

Parameter	Explanation
method_name	Must be "monitoring_services_get".
user_token	User token. To obtain a token please get an account here

Additional parameters

These parameters can be used to specify your request.

Parameter	Explanation
monitor_id	Query can be specified to check a specific monitor
timezone	Numeric value from -12 to +14
date_start	Check time borders can be specified in YYYY-MM-DD format
date_end
int	Data can be requested specifically for the last day (int=1), for the last week (int=7) or for the last month (int=30).

Response

Response example

The server's response is independent of the platform.

{
  "data": [
    {
      "monitor_id": "23550",
      "user_id": "1016905",
      "service_id": null,
      "created": "2025-03-06 19:28:20",
      "URL": "https://cleantalk.org/",
      "status": "ACTIVE",
      "status_updated": "2025-03-06 19:28:20",
      "monitoring_type": "HTTP",
      "share_id": null,
      "check_datetime": "2025-03-13 16:30:52",
      "http_full_response_time": "0.051",
      "http_status": "1",
      "email_notification_sent": "2025-03-07 00:32:25",
      "email_notification_status_sent": "1",
      "session_id": "2fc94c163c5cc1f367f6667bb62d4e68",
      "updown_http_status": "UP",
      "updown_datetime": "2025-03-06 19:28:58",
      "updown_duration": "594208",
      "down_datetime": null,
      "down_duration": null,
      "http_full_response_time_progress": "1.14859",
      "http_full_response_time_avg_1d": "0.0613778",
      "http_full_response_time_avg_7d": "0.0534376",
      "down_events_count_7d": null,
      "down_events_losses_7d": null,
      "http_method": "HEAD",
      "checks_interval": "180",
      "email_notification_delay": "0",
      "checkpoint_ids": "5",
      "pid": 0
    },
 ]
}

Code Examples

Using Wget

CLI example

wget -O- https://api.cleantalk.org/?method_name=monitoring_services_get&monitor_id=1234&user_token=someTokenValue

Using PHP

PHP backend

                                
                                    
                                
                               <?php

$url = "https://api.cleantalk.org/?method_name=monitoring_services_get&monitor_id=1234&user_token=someTokenValue";

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // Use true in production

$response = curl_exec($ch);
$responseString =  "Response:\n" . $response";

curl_close($ch);

Related Links

Available features related to the method:

Uptime Monitoring