POST   checks/generic/{checkId}/results

Gets generic check results in json format.

URL Parameters

NameDescription
checkId

Check identifier. Type: numeric.

Remarks


The default context for the route is the user context. To enable customer context (if it's allowed for the user) use the request query parameter customer_context=1.

Request example and description

curl --request POST "https://api-asm1.apica.io/v3/checks/generic/12345/results?auth_ticket=C471ADC4-19B4-4219-BBF4-671A97EC653E" --header "Content-Type: application/json" --data-raw "{
  \"filter\": {
    \"range\": {
      \"mostrecent\": 10,
      \"milliseconds_utc\": [
        1376980667000,
        1376980667001
      ],
      \"period\": {
        \"from_utc\": \"2013-08-20T13:32:08\",
        \"to_utc\": \"2013-08-21T13:32:08\"
      },
      \"result_ids\": [
        \"8b24ad17-7930-4cb6-a08a-29d7a7aac6b9\",
        \"85ab4264-83fe-45c7-956f-3b9c9661a45c\",
        \"fad72afb-1aef-4a89-b3ad-636db4a3b030\"
      ]
    }
  }
}"
NameType Required Description
filter Object Yes

The filter section defines the criteria for selecting the check results.

range Object Yes

This section allows to define the aggregate range of the results by combining different filters. It must contain at least one filter.

mostrecent Integer No

Number of most recent results.

milliseconds_utc Array No

Array of timestamps associated with results. Each item is represented by a UNIX Epoch timestamp (milliseconds after 1970).

period Object No

The period section defines the date range to obtain results for.

from_utc DateTime Yes

Starting timestamp (in UTC) for the date range.

to_utc DateTime Yes

Ending timestamp (in UTC) for the date range.

result_ids Array No

Array of result identifiers to specific results.

Response body model example and description

{
  "check_id": 1,
  "check_results": [
    {
      "attempts": 1,
      "result_code": 1,
      "timestamp_utc": "2024-11-09T02:03:10",
      "severity": "sample string 3",
      "value": 1,
      "resultId": "6a7eca25-3f2a-4793-b2dc-49729df21baf",
      "result": {}
    },
    {
      "attempts": 1,
      "result_code": 1,
      "timestamp_utc": "2024-11-09T02:03:10",
      "severity": "sample string 3",
      "value": 1,
      "resultId": "6256c622-b65a-4754-9159-31dc92fb52ac",
      "result": {}
    },
    {
      "attempts": 1,
      "result_code": 1,
      "timestamp_utc": "2024-11-09T02:03:10",
      "severity": "sample string 3",
      "value": 1,
      "resultId": "01c0b647-f2e5-4e2f-b56c-bdfdbb5dc00b",
      "result": {}
    }
  ]
}
NameType Description
check_id Integer

The check identifier.

check_results Array

Check results.

attempts Integer

The number of attempts.

result_code Integer

The result code.

timestamp_utc DateTime

The result timestamp in UTC.

severity String

The result severity.

value Integer

The result value.

resultId Guid

The result identifier.

result Object

The custom result data in json format.