---
title: "Performs a single check."
method: GET
path: "/single"
tags: ["Single"]
---

# Performs a single check.

`GET /single`

Performs a single test using a specified Pingdom probe against a specified target. Please note that this method is meant to be used sparingly, not to set up your own monitoring solution.

## Query parameters

- `Query Parameters` union
  - HTTP
    - `host` string, required — Target host
    - `type` 'http', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `url` string — (http specific) Target path on server
    - `encryption` boolean — (http specific) Connection encryption
    - `port` integer — (http specific) Target port
    - `auth` string — (http specific) Username and password for target HTTP authentication.
    - `shouldcontain` string — (http specific) Target site should contain this string
    - `shouldnotcontain` string — (http specific) Target site should NOT contain this string
    - `postdata` string — (http specific) Data that should be posted to the web page, for example submission data for a sign-up or login form. The data needs to be formatted in the same way as a web browser would send it to the web server
    - `requestheader{X}` string — (http specific) Custom HTTP header name. Replace {X} with a number unique for each header argument.
    - `verify_certificate` boolean — (http specific) Treat target site as down if an invalid/unverifiable certificate is found.
    - `ssl_down_days_before` integer — (http specific) Treat the target site as down if a certificate expires within the given number of days. This parameter will be ignored if `verify_certificate` is set to `false`.
  - HTTPCustom
    - `host` string, required — Target host
    - `type` 'httpcustom', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `url` string, required — (httpcustom specific) Target path to XML file on server
    - `encryption` boolean — (httpcustom specific) Connection encryption
    - `port` integer — (httpcustom specific) Target port
    - `auth` string — (httpcustom specific) Username and password for target HTTP authentication.
    - `additionalurls` string — (httpcustom specific) ;-separated list of addidional URLs with hostname included.
  - TCP
    - `host` string, required — Target host
    - `type` 'tcp', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `port` integer, required — (tcp specific) Target port
    - `stringtosend` string — (tcp specific) String to send
    - `stringtoexpect` string — (tcp specific) String to expect in response
  - DNS
    - `host` string, required — Target host
    - `type` 'dns', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'. For example, "region: NA".
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `expectedip` string, required — (dns specific) Expected ip
    - `nameserver` string, required — (dns specific) Nameserver
  - UDP
    - `host` string, required — Target host
    - `type` 'udp', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `port` integer, required — (udp specific) Target port
    - `stringtosend` string — (udp specific) String to send
    - `stringtoexpect` string — (udp specific) String to expect in response
  - SMTP
    - `host` string, required — Target host
    - `type` 'smtp', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `port` integer — (smtp specific) Target port
    - `auth` string — (smtp specific) Username and password for target HTTP authentication.
    - `stringtoexpect` string — (smtp specific) String to expect in response
    - `encryption` boolean — (smtp specific) Connection encryption
  - POP3
    - `host` string, required — Target host
    - `type` 'pop3', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `port` integer — (pop3 specific) Target port
    - `stringtoexpect` string — (pop3 specific) String to expect in response
    - `encryption` boolean — (pop3 specific) Connection encryption
  - IMAP
    - `host` string, required — Target host
    - `type` 'imap', required
    - `probeid` integer — Probe identifier
    - `probe_filters` integer — Filters used for probe selections. Comma separated key:value pairs. Currently only region is supported. Possible values are 'EU', 'NA', 'APAC' and 'LATAM'.
    - `ipv6` boolean — Use ipv6 instead of ipv4
    - `responsetime_threshold` integer — Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.)
    - `port` integer — (imap specific) Target port
    - `stringtoexpect` string — (imap specific) String to expect in response
    - `encryption` boolean — (imap specific) Connection encryption

## Response `200`

Successful operation

- SingleResp
  - `result` object
    - `status` string — Test result status (up, down)
    - `responsetime` integer — Response time in milliseconds
    - `statusdesc` string — Short status description
    - `statusdesclong` string — Long status description
    - `probeid` integer — Probe identifier
    - `probedesc` string — Probe description

---

[API](https://skmtc.net/pingdom/apis/pingdom-public-api.md) · [All operations](https://skmtc.net/pingdom/apis/pingdom-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pingdom/pingdom-public-api/revisions/d05c91a3c64b/schema)