Simplified project status

GET

/project/{id}/simple-status

const url = 'https://testomato.com/api/project/5e9602e7a39e5a46428b457f/simple-status';
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/simple-status \
  --header 'Authorization: Bearer <token>'

Get simplified project status

Authorizations

ApiToken

Parameters

Path Parameters

required

string

A unique project ID

Example

5e9602e7a39e5a46428b457f

Responses

200

Successful response - simplified project status

application/json

object

tests

Array<object>

object

name

string

url

string

status

string

Allowed values: OK Error message

total

Total count of checks

integer

failed

Count of failing checks

Example

{
  "tests": [
    {
      "name": "Homepage",
      "url": "https://testomato.com",
      "status": "OK"
    },
    {
      "name": "Contact",
      "url": "https://testomato.com/contact",
      "status": "Missing \"example\" in Website TEXT"
    }
  ],
  "total": 2,
  "failed": 1
}

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
}