# List labs

Retrieve lab orders and results for the location. Supports filtering by patient, status, and date range.

Endpoint: GET /partner/v2/account/{accountId}/location/{locationId}/lab
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `patientId` (integer)
    Filter by patient ID

  - `appointmentId` (integer)
    Filter by appointment ID

  - `status` (string)
    Filter by status (PROCESSING, COMPLETE, ORDER_ERROR)
    Enum: "PROCESSING", "COMPLETE", "ORDER_ERROR"

  - `vendorType` (string)
    Filter by vendor type (IN_HOUSE, LABCORP, PRIME, BRIO, SPOTDX, OTHER)
    Enum: "IN_HOUSE", "LABCORP", "PRIME", "BRIO", "SPOTDX", "OTHER"

  - `startDate` (string)
    Start of date range (ISO 8601)

  - `endDate` (string)
    End of date range (ISO 8601)

  - `sortBy` (string)
    Sort by field
    Enum: "ENTRY_DATE", "CREATED_DATE"

  - `sortDir` (string)
    Sort direction
    Enum: "ASC", "DESC"

  - `cursor` (string)
    Pagination cursor from previous response

  - `limit` (integer)
    Number of results per page (max 100)
    Example: 20

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

  - `locationId` (integer, required)
    Location identifier

## Response 200 fields (application/json):

  - `labs` (array)
    List of labs

  - `labs.appointmentId` (integer)
    Associated appointment ID

  - `labs.collectedOn` (string)
    Collection date
    Example: "2025-01-15T09:30:00Z"

  - `labs.completedOn` (string)
    Completion date
    Example: "2025-01-16T14:00:00Z"

  - `labs.createdAt` (string)
    Creation timestamp
    Example: "2025-01-15T10:00:00Z"

  - `labs.drawnBy` (string)
    Drawn by (staff name)
    Example: "Jane Smith"

  - `labs.entryOn` (string)
    Entry date
    Example: "2025-01-15T10:00:00Z"

  - `labs.externalResult` (boolean)
    Whether from external source
    Example: true

  - `labs.id` (integer)
    Unique lab identifier
    Example: 12345

  - `labs.locationId` (integer)
    Location ID
    Example: 111

  - `labs.locked` (boolean)
    Whether lab is locked for editing
    Example: true

  - `labs.manual` (boolean)
    Whether manually entered

  - `labs.notes` (string)
    Notes
    Example: "Fasting specimen"

  - `labs.patientId` (integer)
    Patient ID
    Example: 67890

  - `labs.patientName` (string)
    Patient name
    Example: "John Doe"

  - `labs.status` (string)
    Lab status
    Enum: "PROCESSING", "COMPLETE", "ORDER_ERROR"

  - `labs.testPanels` (array)
    Test panels in this lab

  - `labs.testPanels.components` (array)
    Test components in this panel

  - `labs.testPanels.components.abnormalFlag` (string)
    Abnormal flag
    Enum: "BELOW_NORMAL", "WITHIN_NORMAL", "ABOVE_NORMAL"

  - `labs.testPanels.components.externalId` (string)
    External ID from vendor
    Example: "GLU"

  - `labs.testPanels.components.id` (integer)
    Unique component identifier
    Example: 98765

  - `labs.testPanels.components.name` (string)
    Test name
    Example: "Glucose"

  - `labs.testPanels.components.referenceHigh` (string)
    Reference range high
    Example: "100"

  - `labs.testPanels.components.referenceLow` (string)
    Reference range low
    Example: "70"

  - `labs.testPanels.components.referenceText` (string)
    Reference range text (if non-numeric)
    Example: "Negative"

  - `labs.testPanels.components.resultStatus` (string)
    Result status
    Enum: "PRELIMINARY", "FINAL", "CORRECTED", "CANCELLED"

  - `labs.testPanels.components.unit` (string)
    Unit of measurement
    Example: "mg/dL"

  - `labs.testPanels.components.value` (string)
    Result value
    Example: "95"

  - `labs.testPanels.id` (integer)
    Unique panel identifier
    Example: 54321

  - `labs.testPanels.name` (string)
    Panel name
    Example: "Comprehensive Metabolic Panel"

  - `labs.thirdPartyLabId` (string)
    External lab ID from vendor

  - `labs.updatedAt` (string)
    Last update timestamp
    Example: "2025-01-16T14:00:00Z"

  - `labs.vendorId` (integer)
    Lab vendor configuration ID
    Example: 222

  - `labs.vendorName` (string)
    Vendor name
    Example: "Labcorp"

  - `labs.vendorType` (string)
    Lab vendor type
    Enum: "IN_HOUSE", "LABCORP", "PRIME", "BRIO", "SPOTDX", "OTHER"

  - `nextCursor` (string)
    Opaque cursor for fetching the next page


## Response 400 fields

## Response 401 fields

## Response 403 fields