Lab Testing Order Results Guide

Latest Update Time: 2026-06-23 00:00:00

Use the lab testing order results API to retrieve test results and the final report for a specific LT order.

See the Lab Testing Introduction for base URL, authentication, and required headers.

Endpoint

GET https://ppapi.qima.com/v1.2/lt/order-results/{orderId}

Prerequisites

In addition to the required headers and authentication setup:

Permission to view lab testing orders and reports
The LT orderId from an order search, order create, or order detail response
An order that has progressed far enough for test results or a final report to be available

Path Parameters

Parameter	Required	Description
`orderId`	Yes	QIMA internal LT order ID, for example `8acfbf28-3db6-4968-a894-6c7d9f26ef50`. Obtain this value from the order search or order create API response.

Request Example

curl --location 'https://ppapi.qima.com/v1.2/lt/order-results/<order-id>' \
  --header 'Ai-Api-Access-Token: {your api access token}' \
  --header 'Ai-User-Id: {your user ID}' \
  --header 'Authorization: Bearer {your token}' \
  --header 'Referer: https://preprodmy.qima.com/'

Path Parameter Notes

Parameter	Notes
`orderId`	Use `content.data[].generalInformation.orderId` from the order search response, or `content.generalInformation.orderId` from the order create or order detail response.

Successful Response

HTTP 200 OK means the test results and final report information were returned successfully. The response wraps the result data in content, including order summary information, custom fields, final report details, individual test outcomes, and attachments.

{
  "message": "Success",
  "content": {
    "generalInformation": {
      "orderId": "8acfbf28-3db6-4968-a894-6c7d9f26ef50",
      "qimaRefNo": "T-24028173",
      "bookingRefNo": "",
      "testDate": "",
      "reportDate": "",
      "status": "Finished",
      "client": "QIMA_DAISY_LIU_MASTER",
      "clientId": "7F78B7B555EB47A1AE0DD4DCCAD526F2",
      "supplier": "",
      "supplierId": "",
      "submitter": "QIMA_DAISY_LIU_CLIENT",
      "submitterId": "5C9B1F313EE14F95B79372F950F88165",
      "program": "PG_004_rename_12",
      "programId": "1d21b747-f740-41e6-a352-8ea81e2bf71f"
    },
    "customFields": [
      {
        "module": "SampleInfo",
        "label": "DT: Department No.",
        "value": null
      },
      {
        "module": "SampleInfo",
        "label": "T: Synergy Previous Test Report Number",
        "value": null
      },
      {
        "module": "SampleInfo",
        "label": "DT: Sub. Department No.",
        "value": null
      },
      {
        "module": "SampleInfo",
        "label": "Sample Submission",
        "value": null
      }
    ],
    "finalReport": {
      "reportNo": "T-24028173-02-R",
      "reportIssueDate": "",
      "testStartDate": "",
      "reportFile": [
        "https://lab-testing-pp.files.qima.com/8acfbf28-3db6-4968-a894-6c7d9f26ef50/LT%20Client%20report/ABE6AF6361CC4E5390C4AA0C7E989F76/QF-51-21C%2BGulf%2BG-Mark%2BCertificate%2BTemplate%2B29%2BV1.9.odt?Expires=1782190132&Signature=...&Key-Pair-Id=KI7AO157KOC4J"
      ],
      "overallResult": "Pass",
      "poNo": null,
      "yourDecision": "Pending",
      "testDetail": [
        {
          "testId": "8ec5437c-7c25-4d2c-9d4b-1bc2d753d553",
          "clientTestId": null,
          "testName": "1234-test new 2809-test",
          "testResult": "Pass"
        }
      ]
    },
    "attachments": [
      {
        "label": "Client photos",
        "subLabel": null,
        "fileName": "QF-51-21A+Gulf+G-Mark+Certificate+Template+29+V1.9.odt",
        "description": null,
        "url": "https://lab-testing-pp.files.qima.com/8acfbf28-3db6-4968-a894-6c7d9f26ef50/LT%20Client%20photos/733959D3DCF7462092A3F4FF2FF4750C/QF-51-21A%2BGulf%2BG-Mark%2BCertificate%2BTemplate%2B29%2BV1.9.odt?Expires=1782190132&Signature=...&Key-Pair-Id=KI7AO157KOC4J",
        "createdDate": "2026-06-23"
      }
    ]
  }
}

Response Field Notes

Field	Notes
`content.generalInformation`	Core order metadata including `orderId`, `qimaRefNo`, and current `status`. A `Finished` status commonly indicates the order has completed testing.
`content.customFields`	Custom field values associated with the order. These fields must be pre-configured by the QIMA development or business team in the target environment.
`content.finalReport.reportNo`	QIMA final report number, for example `T-24028173-02-R`.
`content.finalReport.overallResult`	Overall test result for the order, such as `Pass` or `Fail`.
`content.finalReport.yourDecision`	Client decision status, such as `Pending`.
`content.finalReport.reportFile`	Array of temporary signed download URLs for the final report file. May be `null` if the report file is not yet ready. URLs expire after the time indicated by the `Expires` query parameter.
`content.finalReport.testDetail`	Individual test results, including `testId`, `testName`, and `testResult` for each assigned test.
`content.attachments`	Files linked to the order, such as client photos or supporting documents. Each item includes `label`, `fileName`, `url`, and `createdDate`.
`content.attachments[].url`	Temporary signed download URL for the attachment. URLs expire after the time indicated by the `Expires` query parameter.

If finalReport.reportFile is null or test results are not yet populated, the order may still be in progress. Retry later or check the order status through the order detail API. Download report and attachment files promptly before the signed URLs expire.

Common Errors

See common authentication errors for 401 and 403 responses.

Status	Meaning	Recommended Action
`400 Bad Request`	The request is invalid.	Confirm the `orderId` path parameter is present and correctly formatted.
`404 Not Found`	The order does not exist or is not accessible.	Confirm the `orderId` is correct and belongs to the authenticated account.
`500 Internal Server Error`	Result retrieval failed on the server.	Contact QIMA support with the request time and `orderId`.

Next Steps

Retrieve full lab testing order details if you need product, sample collection, or recipient information.
Download report files from finalReport.reportFile and order attachments from attachments[].url before the signed URLs expire.

Documents