Endpoint: Fetching Proctoring Evidences

Endpoint: Fetching Proctoring Evidences
January, 2025
GET /api/integration/rest/v1/tasks/:taskId/test-instances/:id/proctoring-evidences

This endpoint lets you fetch all proctoring evidences of a test session under one of your tasks. Proctoring evidences include, among other details, the URLs that contain the proctoring photos/videos .

Query ParametersExpected ValuesDefault
mode"basic" | "detailed""basic"

With the "mode" parameter, you can choose to receive a smaller or a bigger object for each proctoring evidence, depending on your needs.

Response

If the value of mode is "basic", you will receive: 

// "basic" proctoring evidence object
{
    id: string;
    testInstanceId: string;
    taskId: string;
    organizationId: string;
    createdAt: number; //seconds
    kind: "video" | "photo" | "screenshot" | "screencapture";
    url: string;
}

If the value of mode is "detailed", you will receive all of the properties from "basic" and also these properties:

// "detailed" proctoring evidence object:
Basic & {
  owner: {
    kind: "user" | "temp";
    id: string;
  };
  nth: number;
  summary: {
    kind: "video" | "photo" | "screenshot" | "screencapture";
    flag: "CHEATING_ACTIVITY" | "SUSPICIOUS_ACTIVITY" | "SEAMLESS";
    AIDetected: boolean;
     detections: {
       from: "live-proctoring" | "post-proctoring";
       method: "manual" | "ai";
       source: "person-count" | "cheating-activity" | "same-person" | "suspicious-activity" | "forbidden-object" | "face-position";
     }[];
  };
}
Go Back
Talk to a representative
Figure out if TestInvite is a good match for your organization
Book a demo