Response times

GET

/project/{id}/responseTimes

const url = 'https://testomato.com/api/project/5e9602e7a39e5a46428b457f/responseTimes?start=2022-10-31T00%3A00%3A00.000%2B01%3A00&end=2022-10-31T00%3A00%3A00.000%2B01%3A00';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://testomato.com/api/project/5e9602e7a39e5a46428b457f/responseTimes?start=2022-10-31T00%3A00%3A00.000%2B01%3A00&end=2022-10-31T00%3A00%3A00.000%2B01%3A00' \
  --header 'Authorization: Bearer <token>'

Return response times of project in selected period

Authorizations

ApiToken

Parameters

Path Parameters

required

string

A unique project ID

Example

5e9602e7a39e5a46428b457f

Query Parameters

start

required

string

Period start date in ISO 8601 format

Example

2022-10-31T00:00:00.000+01:00

end

string

Period end date in ISO 8601 format (default now)

Example

2022-10-31T00:00:00.000+01:00

Responses

200

Array of response times

application/json

Array<object>

object

responseDate

Response date

string

dnsLookupTime

DNS lookup time

number

initialConnectionTime

Initial connection time

number

sslTime

SSL time

number

requestTime

Request time

number

waitingTime

Waiting time

number

contentDownloadTime

Content download time

number

totalResponseTime

Total response time

number

Example

[
  {
    "responseDate": "2023-03-23T12:53:20+00:00",
    "dnsLookupTime": 3,
    "initialConnectionTime": 17,
    "sslTime": 26,
    "requestTime": 0,
    "waitingTime": 39,
    "contentDownloadTime": 7,
    "totalResponseTime": 89
  },
  {
    "responseDate": "2023-03-23T13:10:00+00:00",
    "dnsLookupTime": 3.5882352941176,
    "initialConnectionTime": 17.352941176471,
    "sslTime": 30.529411764706,
    "requestTime": 0,
    "waitingTime": 42.411764705882,
    "contentDownloadTime": 7.6470588235294,
    "totalResponseTime": 101.05882352941
  },
  {
    "responseDate": "2023-03-23T13:26:40+00:00",
    "dnsLookupTime": 3.5625,
    "initialConnectionTime": 18.5625,
    "sslTime": 30.25,
    "requestTime": 0,
    "waitingTime": 41.375,
    "contentDownloadTime": 7.25,
    "totalResponseTime": 99.1875
  }
]

401

The API token is missing, malformed or expired. Request a new one from POST /api/authenticate.

application/json

object

message

Error message text

string

default: Access denied! Please log in to access this resource.

code

Error code number

integer

default: 401

boolean

error

boolean

default: true

Example

{
  "message": "Access denied! Please log in to access this resource.",
  "code": 401,
  "ok": false,
  "error": true
}

403

The token is valid but the operation is not allowed. Two distinct causes:

the subscription plan does not include API access — every endpoint returns this, regardless of the resource
the account lacks the required role on the project — reading needs read, changing checks needs editTests, and so on. See Project permissions.

application/json

object

message

Error message text

string

default: Sorry! Your current plan does not support access to Testomato API.

code

Error code number

integer

default: 403

boolean

error

boolean

default: true

Example

{
  "message": "Sorry! Your current plan does not support access to Testomato API.",
  "code": 403,
  "ok": false,
  "error": true
}

405

Start time is empty or invalid (use ISO8601 date format)

application/json

object

message

Error message

string

default: Start time is empty or invalid (use ISO8601 date format)

success

boolean

error

boolean

default: true

Example

{
  "message": "Start time is empty or invalid (use ISO8601 date format)",
  "success": false,
  "ok": false,
  "error": true
}