Lab Testing Order Detail Guide

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

Use the lab testing order detail API to retrieve comprehensive information 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/orders/{orderId}

Prerequisites

In addition to the required headers and authentication setup:

Permission to view lab testing orders
The LT orderId from an order search or order create response

Path Parameters

Parameter	Required	Description
`orderId`	Yes	QIMA internal LT order ID, for example `70660b93-a29a-4def-b0da-9bd982adf7f3`. Obtain this value from the order search or order create API response.

Request Example

curl --location 'https://ppapi.qima.com/v1.2/lt/orders/<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 response.

Successful Response

HTTP 200 OK means the order details were returned successfully. The response wraps the full order information in content, including product details, tests, sample collection, custom fields, recipients, and attachments.

{
  "message": "Success",
  "content": {
    "generalInformation": {
      "orderId": "70660b93-a29a-4def-b0da-9bd982adf7f3",
      "qimaRefNo": "T-26012277",
      "bookingRefNo": "BOOK-2026-001",
      "testDate": "",
      "reportDate": "",
      "status": "Validation",
      "client": "ABC QIMA Sandbox",
      "clientId": "0F521098B7154460A50303EEE7A61A16",
      "supplier": "",
      "supplierId": "",
      "submitter": "ABC QIMA Sandbox",
      "submitterId": "0F521098B7154460A50303EEE7A61A16",
      "program": "DEFAULT",
      "programId": "05ef9e73-479a-40c2-a2db-812daaed3e1e"
    },
    "product": {
      "productName": "Children Toy Sample",
      "purchaseOrderNo": "PO-2026-001",
      "sku": "SKU-2026-001",
      "materials": "Cotton, Polyester",
      "ageGrade": "3+",
      "program": "DEFAULT",
      "programId": "05ef9e73-479a-40c2-a2db-812daaed3e1e",
      "distributionRegions": ["Austria"],
      "distributionCountries": ["China"],
      "originCountries": ["Japan"],
      "manufacturerFactoryName": "ABC Factory",
      "agencyName": "Agency ABC",
      "buyerName": "XYZ Company",
      "shipmentDate": "",
      "bookingRemark": ""
    },
    "tests": [
      {
        "testId": "24671365-76d4-4ed7-b6be-2b92d6bfa59f",
        "clientTestId": null,
        "testName": "EN 71-3:2019-Toys-Migration of Certain Elements (Cat III) - All Inclusive",
        "testResult": null
      }
    ],
    "customFields": [
      {
        "module": "SampleInfo",
        "label": "Test Field 3",
        "value": "Created by API integration"
      }
    ],
    "sampleCollection": [
      {
        "method": "Courier",
        "carrier": "DHL",
        "trackingNo": "TRACK-2026-001",
        "remarks": "Handle with care",
        "inspectionOrderReference": null
      }
    ],
    "additionalRecipients": {
      "reportEmailTo": "report@example.com",
      "reportEmailCC": "cc@example.com",
      "invoiceEmailTo": "invoice@example.com",
      "invoiceEmailCC": "invoice-cc@example.com",
      "quotationEmailTo": "quotation@example.com",
      "quotationEmailCC": "quotation-cc@example.com"
    },
    "attachments": []
  }
}

Response Field Notes

Field	Notes
`content.generalInformation`	Core order metadata including `orderId`, `qimaRefNo`, `status`, client, supplier, and program information.
`content.product`	Product details submitted with the order, including SKU, materials, distribution regions, and buyer information.
`content.tests`	Assigned tests with QIMA test names, IDs, and results when available.
`content.customFields`	Custom field values stored on the order. These fields must be pre-configured by the QIMA development or business team in the target environment.
`content.sampleCollection`	Sample collection method, carrier, tracking number, and related remarks.
`content.additionalRecipients`	Email recipients configured for report, invoice, and quotation notifications.
`content.attachments`	Files linked to the order. Returns an empty array when no attachments exist.

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`	Order detail retrieval failed on the server.	Contact QIMA support with the request time and `orderId`.

Next Steps

Retrieve lab testing order test results when the report is available.
Upload attachments to the order when additional documents are required — see the Order Attachments Guide.
Update the order if changes are allowed for the current order status — see the Order Update Guide.

Documents