---
title: "One page of a lab work queue (ITE-638)."
method: GET
path: "/Labs/queue/{queue}"
tags: ["Labs"]
---

# One page of a lab work queue (ITE-638).

`GET /Labs/queue/{queue}`

Replaces the unpaged `pending-review` endpoint. The queues are selected by the server
     now: they used to be client-side slices of `GET /labs` fetched unfiltered and unpaged,
     which made the screen scale with a clinic's whole lab history rather than with the size of
     the queue.

     take is capped by the repository, so an omitted or oversized page size still returns
a bounded response.

## Path parameters

- `queue` integer, required — The lab work queues, as a thing the <b>server</b> can select (ITE-638). These four already existed — as client-side slices of every lab order in the tenant. The Userhub panel fetched `GET /labs` unfiltered and unpaged so all four rails could share one cache entry, then narrowed in the browser. That scales with a clinic's entire lab history rather than with the size of the queue, which is why one 200-order import made the screen slow enough that Courtney kept it open in a second window.The tasks queries hit this first and solved it the same way — lifecycle: "open" and unassignedOnly exist so the server does the narrowing. This is the lab equivalent.

## Query parameters

- `skip` union
  - integer
  - string, int32
- `take` union
  - integer
  - string, int32
- `orderedById` string

## Response `200`

OK

- LabOrderListResponseDto
  - `data` LabOrderDto[]
    - `id` string
    - `patientId` string
    - `patient` LabPatientSummaryDto
      - `id` string
      - `name` string
      - `species` string, nullable
      - `ownerName` string, nullable
    - `orderedById` string, nullable
    - `orderedBy` LabUserSummaryDto
      - `id` string
      - `name` string
      - `role` string, nullable
    - `appointmentId` string, nullable
    - `title` string
    - `testType` string
    - `status` string
    - `resultStatus` string
    - `source` string
    - `externalId` string, nullable
    - `performingLabName` string, nullable — The laboratory behind the Greywind hub that actually ran this, and its id (ITE-552). Null when the order did not come through Greywind, or when the partner directory had not been mirrored when the result landed — the sync backfills the name in that case.
    - `externalPartnerId` string, nullable
    - `submissionUnconfirmedAt` string, date-time, nullable — Set when the submission's outcome was never confirmed with the laboratory (ITE-494) — the order may or may not be live there, and it must never be resubmitted on a guess.
    - `submissionIssue` string, nullable
    - `sampleArrivedAt` string, date-time, nullable — When the laboratory confirmed the sample arrived (ITE-494). Null if they have not.
    - `accessionNumber` string, nullable
    - `collectedAt` string, date-time, nullable
    - `resultsReceivedAt` string, date-time, nullable
    - `reviewedById` string, nullable
    - `reviewedBy` LabUserSummaryDto
      - `id` string
      - `name` string
      - `role` string, nullable
    - `reviewedAt` string, date-time, nullable
    - `summary` string, nullable
    - `reportUrl` string, nullable
    - `priority` string
    - `labPanelId` string, nullable
    - `submissionGroupId` string, nullable — Groups sibling orders created by one external submission (ITE-493). Null for manual orders.
    - `manifestFileId` string, nullable — PatientFile id of the stored requisition manifest, when the order went to an external lab.
    - `requiresPartnerAction` boolean — True while the order still needs partner-hosted pages completed before it is really placed.
    - `results` LabResultDto[]
      - `id` string
      - `labOrderId` string
      - `testName` string
      - `testCode` string, nullable
      - `value` string
      - `numericValue` union
        - number, double
        - string, double
      - `unit` string, nullable
      - `referenceRange` string, nullable
      - `referenceLow` union
        - number, double
        - string, double
      - `referenceHigh` union
        - number, double
        - string, double
      - `flag` string, nullable — The flag name, or null when none was reported and none could be derived (ITE-548). Clients must render null as its own state — not as a badge in either direction.
      - `displayOrder` union
        - integer
        - string, int32
      - `comment` string, nullable
      - `createdAt` string, date-time
      - `supersededAt` string, date-time, nullable — Set when a later report replaced this value (ITE-492). Null means this is the value that currently stands. Superseded rows are returned rather than filtered out on purpose: a clinician who acted on the original needs to see that it changed, not just the new number appearing as if it had always been there.
      - `supersededByResultId` string, nullable — The result that replaced this one, when superseded.
      - `referenceIntervalAmendedAt` string, date-time, nullable — Set when a clinician corrected this result's reference interval (ITE-499). Null means the interval is still exactly what the laboratory or analyzer sent. Clients must surface this. A value flagged against a corrected interval is a different clinical claim from one flagged against the lab's own, and a reader who cannot tell the two apart cannot judge how much to trust the flag.
      - `amendments` LabResultAmendmentDto[] — The correction trail, oldest first. Empty for the overwhelming majority of results.
        - `id` string
        - `originalReferenceLow` union
          - number, double
          - string, double
        - `originalReferenceHigh` union
          - number, double
          - string, double
        - `originalReferenceRange` string, nullable
        - `amendedReferenceLow` union
          - number, double
          - string, double
        - `amendedReferenceHigh` union
          - number, double
          - string, double
        - `amendedReferenceRange` string, nullable
        - `originalFlag` string, nullable — Flag name before the correction, or null when none was ever asserted.
        - `amendedFlag` string, nullable — Flag name after re-derivation, or null when the corrected interval implies none.
        - `reason` string, nullable
        - `amendedById` string, nullable
        - `amendedByName` string, nullable — Always populated — "System" when there is no human author, so the trail cannot render as a blank that reads like a missing record.
        - `createdAt` string, date-time
    - `notes` LabNoteDto[]
      - `id` string
      - `labOrderId` string
      - `authorId` string, nullable — Null for a system-generated note, which has no human author (ITE-550).
      - `authorName` string, nullable — Always populated — "System" when there is no author. Never blank.
      - `content` string
      - `isSystemGenerated` boolean
      - `createdAt` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `totalCount` union
    - integer
    - string, int32

## Changes

- **2026-09-02** `061f8d95e1d1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/Labs/queue/:queue/get.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) · [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clinicos/pawthosx-business-api-v1/revisions/061f8d95e1d1/schema)