Introduction to REST API

Introduction to Testinvite's REST API system. Documentation for the endpoints, requests & responses, use-cases and more
January, 2025

Testinvite offers a REST API system for clients to integrate our system into theirs and automate the workflow. 

Services are offered in REST API

The REST API services include the following:

  • Listing your Tasks
    • Listing your Tests
      • Listing your Users
        • Listing your Test Sessions & Results
          • Creating Candidates under a Task
            • Listing Monitoring Assets of a Test Session.

              Authentication

              To authenticate requests to the API, include your organization's authorization token in the Authorization header of each HTTP request. You can find your unique token on your organization's page. Use the following format:

              Authorization: <your-token>

              Ensure the token is kept secure, as it provides access to your organization's data.

              Endpoint List 

              Please find below the endpoints for the REST API service. The root for the endpoints is https://www.testinvite.com.

              ResourcePurposeRouteHTTP MethodDocumentation
              TasksFetch multiple tasks/api/integration/rest/v1/tasksGETClick
              Fetch one task by its id/api/integration/rest/v1/tasks/:idGETClick
              Fetch one task by its id and get additional details /api/integration/rest/v1/tasks/:id/queryPOSTClick
              TestsFetch multiple tests/api/integration/rest/v1/testsGETClick
              Fetch one test by its id/api/integration/rest/v1/tests/:idGETClick
              Fetch one test by its id and get additional details /api/integration/rest/v1/tests/:id/queryPOSTClick
              UsersFetch multiple users/api/integration/rest/v1/usersGETClick
              Fetch one user by its id/api/integration/rest/v1/users/:idGETClick
              Test instancesFetch multiple test instances/api/integration/rest/v1/test-instancesGETClick
              Fetch one test instance by its id/api/integration/rest/v1/test-instances/:idGETClick
              Fetch one test instance by its id and get additional details/api/integration/rest/v1/test-instances/:id/queryPOSTClick
              Fetch proctoring evidences of a test session/api/integration/rest/v1/test-instances/:id/proctoring-evidencesGETClick
              CandidatesFetch one candidate by its id/api/integration/rest/v1/tickets/:idGETClick
              Create a candidate under a task/api/integration/rest/v1/ticketsPOSTClick
              Go Back
              Talk to a representative
              Figure out if TestInvite is a good match for your organization
              Book a demo