StartExam API

Register Employees

Method registers employees for a test and returns identifiers that can be used to start the test.

Request Information

Scheme

POST https://api.startexam.com/v2/employees-participants

URI Parameters

None

Body Parameters

Json with the RegisterParticipantsQuery, see details and example below.

  • center - center unique name. The value can be retrieved from the center details page.
  • validFrom - session link activation time, UTC, ISO 8601.
  • validTill - session link expiration time, UTC, ISO 8601.
  • proctoring - enable proctoring (applicable only for accounts with enabled proctoring)
  • proctoringActivationParameters - proctoring parameters (applicable only with enabled proctoring)
  • doNotCreateIfExist - do not create new registration if employee has been already registered for center and test
  • tests - from 1 to 10 test identifiers, Guid.
  • employees - from 1 to 500 employees identifiers.

Request Example

POST https://api.startexam.com/v2/employees-participants 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
Content-Length: 518
Date: Fri, 11 Jul 2025 06:51:57 GMT

{
  "center": "mycenter",
  "validFrom": "2025-07-11T00:00:00Z",
  "validTill": "2025-07-21T23:59:59Z",
  "proctoring": true,
  "proctoringActivationParameters": [
    {
      "name": "Type",
      "value": "Offline"
    },
    {
      "name": "AuxiliaryCamera",
      "value": "true"
    }
  ],
  "doNotCreateIfExist": false,
  "tests": [
    "e5e882ea-6a58-4a7a-8f54-21cd87196896"
  ],
  "employees": [
    {
      "id": "willis74"
    },
    {
      "id": "knightly32"
    },
    {
      "id": "covey77"
    }
  ]
}

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

Identifiers of registered participants (sessions for employees).

Use the URL mask below to construct a unique link for employee and redirect him to his exam:

https://go.startexam.com/{center}#participant/{id}

Response Example

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

{
  "participantIds": [
    "9e80b1b5-de79-4810-9352-4a6d4e9b04c7",
    "63c532ea-3168-4e5b-84a7-71608f7aa535",
    "d598ed79-5b5d-4586-9b9b-6065ea84169b"
  ]
}

To redirect the first participant (willis74) to the assessment you can use URL:

https://go.startexam.com/mycenter#participant/9e80b1b5-de79-4810-9352-4a6d4e9b04c7

Try Method