Skip to content

Get lab by ID

Request

Retrieve detailed information about a lab including all test components.

Security
PartnerApiKey and PartnerOAuth
Path
labIdinteger, (int64)required

Lab ID

accountIdinteger, (int64)required

Account identifier

locationIdinteger, (int64)required

Location identifier

curl -i -X GET \
  'https://api-docs.lobbie.com/_mock/openapi/partner/v2/account/{accountId}/location/{locationId}/lab/{labId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Responses

Lab found and returned successfully

Bodyapplication/json
appointmentIdinteger, (int64)

Associated appointment ID

collectedOnstring, (date-time)

Collection date

Example:"2025-01-15T09:30:00Z"
completedOnstring, (date-time)

Completion date

Example:"2025-01-16T14:00:00Z"
createdAtstring, (date-time)

Creation timestamp (UTC)

Example:"2025-01-15T14:00:00Z"
drawnBystring

Drawn by (staff name)

Example:"Jane Smith"
entryOnstring, (date-time)

Entry date

Example:"2025-01-15T10:00:00Z"
externalResultboolean

Whether from external source

Example:true
idinteger, (int64)

Unique lab identifier

Example:12345
locationIdinteger, (int64)

Location ID

Example:111
lockedboolean

Whether lab is locked for editing

Example:true
manualboolean

Whether manually entered

Example:false
notesstring

Notes

Example:"Fasting specimen"
patientIdinteger, (int64)

Patient ID

Example:67890
patientNamestring

Patient name

Example:"John Doe"
statusstring

Lab status

Enum:"PROCESSING""COMPLETE""ORDER_ERROR"
Example:"COMPLETE"
testComponentsArray of objects(TestComponentDTO)

All test results for this lab.

thirdPartyLabIdstring

External lab ID from vendor

updatedAtstring, (date-time)

Last update timestamp (UTC)

Example:"2025-01-15T14:00:00Z"
vendorNamestring

Vendor name

Example:"Labcorp"
vendorTypestring

Lab vendor type

Enum:"IN_HOUSE""LABCORP""PRIME""BRIO""SPOTDX""OTHER"
Example:"LABCORP"
Response
{
  "appointmentId": 0,
  "collectedOn": "2025-01-15T09:30:00Z",
  "completedOn": "2025-01-16T14:00:00Z",
  "createdAt": "2025-01-15T14:00:00Z",
  "drawnBy": "Jane Smith",
  "entryOn": "2025-01-15T10:00:00Z",
  "externalResult": true,
  "id": 12345,
  "locationId": 111,
  "locked": true,
  "manual": false,
  "notes": "Fasting specimen",
  "patientId": 67890,
  "patientName": "John Doe",
  "status": "COMPLETE",
  "testComponents": [
    { … }
  ],
  "thirdPartyLabId": "string",
  "updatedAt": "2025-01-15T14:00:00Z",
  "vendorName": "Labcorp",
  "vendorType": "LABCORP"
}