Skip to main content

Lab Test Details and Bulk Actions

Managing lab test details and bulk actions allows labs to execute test requests and collaborate more efficiently with stakeholders. Through Inspectorio’s API, labs can retrieve detailed information on test requests, upload test data, and perform bulk actions, such as updating statuses or adding comments. This ensures that labs have the necessary data to meet client expectations and effectively manage lab tests.

Precondition

Generate an API key for your organization and use it to authenticate your API requests.

Get list of lab tests

Labs can retrieve the list of test requests assigned to them through the Get List Lab Tests endpoint. The list provides an overview of all active test requests, allowing labs to monitor and manage their testing workload effectively.

To access this list, use the Get List Lab Tests API endpoint.

By frequently polling this endpoint, labs can stay updated on new test requests and any changes to existing ones. The response contains information on each test’s status, enabling labs to prioritize tasks and respond to updates in real time.

Upload/update pre-created lab test

Once test execution is complete, labs need to upload results, reports, and any supporting documentation to the Inspectorio platform. This ensures all stakeholders have access to the final test data and can make informed decisions based on the results.

Before uploading, attachments must first be sent to the Inspectorio File Management Server using the Create File Upload Session API endpoint.

The API response indicates whether the upload was successful and ensures that the data points can be viewed within the Inspectorio platform.

To upload or update lab test data, use the Upload/Update Pre-Created Lab Test API endpoint.

Uploaded test results can be viewed on the lab test details page on the platform.

Alt text

Get lab test details

For more specific information on an individual test request, labs can retrieve detailed data. This enables labs to access comprehensive information on each test, including critical data fields and any integration keys previously aligned with Inspectorio.

To retrieve information for a specific test request, use the Get Lab Test Detail API endpoint.

Labs can also access this data by scanning the barcode on the test request printout attached to physical samples, or by entering the unique 10-digit test ID. This feature helps labs to mirror test details in their own systems for enhanced record-keeping.

Alt text

Post bulk action on lab tests

Bulk actions enable labs to update test statuses and communicate with stakeholders. Labs can start tests, reject or abort test requests with incorrect data, and add comments, as needed.

To post bulk actions, use the Bulk Action Lab Test API endpoint.

This API supports several bulk actions:

  • LT_START: Begins the test, logs the sample receipt date, and updates the test status to In progress.
  • LT_REJECT: Rejects tests with critical errors when the sample logging process is not yet started.
  • LT_ABORT: Aborts tests with critical errors when the sample logging process has been started.
  • LT_COMMENT: Adds comments for stakeholders, which can help with communication, particularly with vendors.

Comments and other activities performed in the test are recorded and can be viewed on the Activities log of the lab test.

Alt text