GET   checks/config?checktype={checktype}

Gets configuration of all checks. Supported check types: DAC, URLv2 and Chrome Browser Checks.

URL Parameters

NameDescription
checktype

(Optional) The following values are applicable: url, fpr and dac

Remarks

The example response shown below is for check type url-v2. This may vary for different check types.

Request example

Response body model example and description

{
  "Timeout": 1,
  "ConnectionTimeout": 1,
  "url": "https://cldemo.apica.io/",{"\n"}{"  "}"content_pattern_type": "literal",
  "content_pattern": "ok",
  "content_pattern_case_sensitive": false,
  "request_method": "GET",
  "post_data": "{ "check_id": 12345}",
  "custom_hdrs": {
    "X-check-id": "12345",
    "X-private-req": "true"
  },
  "max_redirects": 3,
  "disable_certificate_verification": true,
  "authentication": {
    "type": "none",
    "username": "user",
    "password": "pass"
  },
  "proxy": {
    "type": "socks4",
    "host": "10.211.55.4",
    "port": "1080",
    "auth_type": "none",
    "username": "user",
    "password": "pass"
  },
  "VerifyPort": "sample string 1",
  "Enabled": 1,
  "AcceptedCodes": "sample string 2",
  "CodeSev": "sample string 3",
  "ReqHdrs": true,
  "RspHdrs": true,
  "IncludeResponseBody": true,
  "SecureProtocolVersion": "sample string 4",
  "Http2": true,
  "fail_over": true,
  "name": "Test check",
  "description": "It is a test check.",
  "monitor_groups_ids": [
    34,
    35,
    36
  ],
  "interval_seconds": 3600,
  "interval_manual": true,
  "max_attempts": 3,
  "attempt_pause": 30000,
  "location_code": "b8dce6d7-2222-1111-92e9-4a98eb706b13|europe.northern-europe.se.na.stockholm.ipv6-aaaaa|chromium|87",
  "secondary_location_codes": null,
  "check_fail_severity": "F",
  "threshold_w": 15000,
  "threshold_w_set_0": true,
  "threshold_w_dynamic": {
    "baseline_measure": "avg",
    "baseline_period_h": 2,
    "factor": 2.0,
    "offset": 0
  },
  "threshold_e": 25000,
  "threshold_e_set_0": false,
  "threshold_e_dynamic": {
    "baseline_measure": "avg",
    "baseline_period_h": 2,
    "factor": 2.0,
    "offset": 0
  },
  "threshold_lo_w": 5000,
  "threshold_lo_w_set_0": true,
  "threshold_lo_w_dynamic": {
    "baseline_measure": "avg",
    "baseline_period_h": 2,
    "factor": 2.0,
    "offset": 0
  },
  "threshold_lo_e": 10000,
  "threshold_lo_e_set_0": false,
  "threshold_lo_e_dynamic": {
    "baseline_measure": "avg",
    "baseline_period_h": 2,
    "factor": 2.0,
    "offset": 0
  },
  "tags": [
    1,
    2,
    3
  ],
  "scheduled_inclusion": "mon-fri: 21:30-22; sun:15-17; 0-1:12-18; 2012-04-01-2012-04-30:18-23",
  "scheduled_exclusion": "mon-fri: 21:30-22; sun:15-17; 0-1:12-18; 2012-04-01-2012-04-30:18-23",
  "target_sla": 0.9,
  "target_sla_2": 0.9,
  "verify_ping": "fast.com",
  "CheckID": 6,
  "CheckGUID": "635e945a-0b1b-49e6-aabe-bb1cec07f8b0"
}
NameType Description
urlString

URL.

content_pattern_typeString

Response Content Verification Type. Available values: 'literal', 'regex'. Regex performs matching against the content with Regular Expressions. Literal matches using a basic string.

content_patternString

Content pattern.

content_pattern_case_sensitiveBoolean

Case sensitive content pattern. Enabling this option will make the Response Content Verification Pattern case sensitive.

request_methodString

HTTP request method.

post_dataString

Data for POST request.

custom_hdrsObject

Request headers.

max_redirectsInteger

Maximum number of redirects.

disable_certificate_verificationBoolean

Disable Certificate Verification.

authenticationObject

Authentication data.

typeString

Authentication type. Available values: 'none', 'basic'.

usernameString

Username.

passwordString

Password.

proxyObject

Proxy data.

typeString

Proxy type. Available values: 'none', 'http', 'socks4', 'socks5'.

hostString

Proxy (DNS) hostname or TCP/IP address.

portString

Proxy TCP/IP port number.

auth_typeString

Proxy authentication type. Available values: 'none', 'basic', 'digest'.

usernameString

Proxy authentication username.

passwordString

Proxy authentication password.

VerifyPortString

Verify port.

EnabledInteger

Enabled. Default value is 1.

AcceptedCodesString

Accepted codes. Default value is 200.

CodeSevString

Code severity. Default value is F.

ReqHdrsBoolean

Store Request Headers. Default value is true.

RspHdrsBoolean

Store Response Headers. Default value is true.

SecureProtocolVersionString

Secure protocol version. Available values: 'default', 'sslv3', 'tlsv1'

Http2Boolean

Enable HTTP2.

CheckTypeObject

No documentation available.

value__Integer

No documentation available.

fail_overBoolean

With Failover enabled the check will be executed on a second location if the result is not OK (Information). Only one attempt will be made from the failover location.

nameString

The name of the check.

descriptionString

The check description.

monitor_groups_idsArray

ID of monitor groups in which a check will be included.

interval_secondsInteger

Check run interval in seconds.

interval_manualBoolean

The flag indicating whether check runmode is manual or interval.

max_attemptsInteger

The max number of attempts that can be made to verify the results. This setting applies to the primary location only, not any failover locations. Available values: from 1 to 5.

attempt_pauseInteger

Between every attempt there will be an Attempt Pause before the next attempt is performed. Milliseconds. Available values : 0, 50, 100, 200, 500, 1000, 2000, 3000, 5000, 10000, 20000, 30000, 60000.

location_codeString

The check run location.

secondary_location_codesArray

Currently not supported.

check_fail_severityString

This will be the Severity that the check will get if it fails. This can be used to trigger a different Severity (and at the end, different alerts). I - Information, W - Warning, E - Error, F - Fatal. Default is F.

threshold_wInteger

The value of high warning threshold. If not specified then no threshold.

threshold_w_set_0Boolean

The flag indicating whether or not the high warning threshold should be set to 0.

threshold_w_dynamicObject

The object for configuring dynamic calculation of high warning threshold. If not specified then no dynamic calculation.

baseline_measureString

The baseline for calculating dynamic threshold. Available values: 'avg', 'mdn', 'std'.

baseline_period_hInteger

The period in hours for calculation depending on the specified baseline.

factorFloat

The percentage of the average/median return value or standard deviation of the return value.

offsetInteger

The period's offset in hours.

threshold_eInteger

The value of high error threshold. If not specified then no threshold.

threshold_e_set_0Boolean

The flag indicating whether or not the high error threshold should be set to 0.

threshold_e_dynamicObject

The object for configuring dynamic calculation of high error threshold. If not specified then no dynamic calculation.

baseline_measureString

The baseline for calculating dynamic threshold. Available values: 'avg', 'mdn', 'std'.

baseline_period_hInteger

The period in hours for calculation depending on the specified baseline.

factorFloat

The percentage of the average/median return value or standard deviation of the return value.

offsetInteger

The period's offset in hours.

threshold_lo_wInteger

The value of low warning threshold. If not specified then no threshold.

threshold_lo_w_set_0Boolean

The flag indicating whether or not the low warning threshold should be set to 0.

threshold_lo_w_dynamicObject

The object for configuring dynamic calculation of low warning threshold. If not specified then no dynamic calculation.

baseline_measureString

The baseline for calculating dynamic threshold. Available values: 'avg', 'mdn', 'std'.

baseline_period_hInteger

The period in hours for calculation depending on the specified baseline.

factorFloat

The percentage of the average/median return value or standard deviation of the return value.

offsetInteger

The period's offset in hours.

threshold_lo_eInteger

The value of low error threshold. If not specified then no threshold.

threshold_lo_e_set_0Boolean

The flag indicating whether or not the low error threshold should be set to 0.

threshold_lo_e_dynamicObject

The object for configuring dynamic calculation of low error threshold. If not specified then no dynamic calculation.

baseline_measureString

The baseline for calculating dynamic threshold. Available values: 'avg', 'mdn', 'std'.

baseline_period_hInteger

The period in hours for calculation depending on the specified baseline.

factorFloat

The percentage of the average/median return value or standard deviation of the return value.

offsetInteger

The period's offset in hours.

tagsArray

List of tag IDs.

scheduled_inclusionString

Inclusion Periods (Default: always).

scheduled_exclusionString

Exclusion Periods (Default: none).

target_slaFloat

Sets a 1st Target SLA in percentage e.g. 99.5 or 99. This is used in certain types reports. Set 0 to reset the value.

target_sla_2Float

Sets a 2nd Target SLA in percentage e.g. 99.5 or 99. This is used in certain types reports. Set 0 to reset the value.

verify_pingString

After a failed result, verify connection against this hostname with a ping request.

CheckIDInteger

No documentation available.

CheckGUIDGuid

No documentation available.

TimeoutInteger

Timeout. Default value is 45.

ConnectionTimeoutInteger

Connection timeout. Default value is 10.