Get Tests

Method returns tests list from StartExam using specified filters.

Request Information

Scheme

GET https://api.startexam.com/v1/tests?projectId={projectId}&type={type}&status={status}

URI Parameters

  • projectId - optional filter by project identifier, guid from StartExam.
  • type - optional filter by type. Supported values: test , survey.
  • status - optional filter by status. Supported values: active , archive , deleted.

Body Parameters

None.

Request Example

GET https://api.startexam.com/v1/tests?projectId=bd3e68a5-95b5-4577-8de5-fb20a9fa02d9 HTTP/1.1
Host: api.startexam.com
Accept: application/json; charset=utf-8
Authorization: SharedKey 99:f52JP7GQd0xqrBzMO1NWTNVGzLENymgdUXu/Ie++NX4=
Content-Type: application/json; charset=utf-8
Date: Mon, 21 Sep 2020 12:35:02 GMT

Date and Authorization headers are constructed in the standard way.

Response Information

HTTP status code

200 OK, 400 Bad Request, etc. according the response processing guide.

Content-Type

Json.

Content

  • testId - test id, guid.
  • projectId - project id, guid.
  • type - test type, test/survey.
  • status - test status, active/archive/deleted.
  • title - test name, string.
  • description - test description, string, nullable.
  • time - test time limit, HH:MM:SS, nullable.
  • modified - test last modified in UTC, ISO 8601.

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 680

{
  "tests": [
    {
      "testId": "c4c65fb8-7b43-49c0-9c80-8bd229061af6",
      "projectId": "bd3e68a5-95b5-4577-8de5-fb20a9fa02d9",
      "type": "test",
      "status": "active",
      "title": "IQ Test",
      "description": "Standard intelligence quotient assessment",
      "time": "02:00:00",
      "modified": "2019-11-21T12:35:02Z"
    },
    {
      "testId": "a8b571de-5b34-4e54-93f0-2b7664049b13",
      "projectId": "bd3e68a5-95b5-4577-8de5-fb20a9fa02d9",
      "type": "survey",
      "status": "deleted",
      "title": "Motivation Survey",
      "description": null,
      "time": null,
      "modified": "1990-09-21T12:35:02Z"
    }
  ]
}

Try Method