GET /API/Tests/Checks

Basic Intro

Using the HTTP header GET you will be able to get a list of each and every test carried out. At any one time this call will return a days worth of results and you are able to cycle through each of the results using the request var of Start. The latest tests are shown first. This will only work for paying customers

Parameters
`REQUIRED`
    POST/GET - TestID. This should be a int of a test ID attached to the logged in account.
`OPTIONAL`
    POST/GET - Fields. See Below for more information
    POST/GET - Start. You can also pass a Unix time stamp to return results SINCE this timestamp. 
    POST/GET - Limit. Limits to a subset of results - maximum of 1000.  
Example Request
curl -H "API: [APIKey]" -H "Username: [Username]" -X GET https://app.statuscake.com/API/Tests/Checks?TestID=[TestID]

Example Output

The output is returned as a json array

{
"3986660001": {"Location":"WADA3","Time":1413285656,"Status":200},
"3027990001": {"Location":"DOUK2","Time":1413285239,"Status":200},
"3322390001": {"Location":"UK50","Time":1413285124,"Status":200}
}

Fields

You can request addition fields, these additional feilds will give you more data about each check. The fields you wish to use should be sent via the Fields element, comma seperated eg &Fields=time,headers

status - Returns the status code provided
location - Returns the server the test was performed on
human - Human readable timestamp. Converted to the timezone of the account
time - A unix timestamp of when the test completed
headers - Returns the response headers from the test taken
performance - Returns the performance (in ms)

Changes

14/10/2014

We've made a lot of changes to the response provided from the /API/Tests/Tests call and have such renamed the call; you should attempt to move over to the new format as soon as possible as it offers spread a vastly improved speed increase and enables for more control of what is returned. In addition to the format changes we've also added the ability to get the response header. We're going to be looking at adding further data in time however the format is now locked in.

Order has been removed due to the new format the data is stored in, you should cycle through and keep a record of the last time provided and then request data since then with the Start field.