Guides

Lab Results

How to retrieve Cortex lab diagnostic results via the Vetigen API.

Lab Results Guide

Access diagnostic lab results captured by Vetigen Cortex (lab device integration system). Requires the diagnostics:read scope.

Get a Diagnostic Study

Retrieve a specific lab result by its fingerprint.

curl https://api.vetigen.com/api/v1/cortex/diagnostics/cds_01JQMKXXXXX \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

Response

{
  "success": true,
  "data": {
    "fp": "cds_01JQMKXXXXX",
    "type": "BLOOD_CHEMISTRY",
    "status": "COMPLETED",
    "patient": {
      "fp": "patient_01JQMKXXXXX",
      "name": "Luna",
      "species": "cat"
    },
    "device": {
      "model": "IDEXX Catalyst One",
      "serial": "CAT-123456"
    },
    "results": [
      {
        "analyte": "ALT",
        "value": 45.2,
        "unit": "U/L",
        "reference_min": 12,
        "reference_max": 100,
        "flag": "NORMAL"
      },
      {
        "analyte": "BUN",
        "value": 32.1,
        "unit": "mg/dL",
        "reference_min": 14,
        "reference_max": 36,
        "flag": "NORMAL"
      },
      {
        "analyte": "CREA",
        "value": 2.8,
        "unit": "mg/dL",
        "reference_min": 0.8,
        "reference_max": 2.4,
        "flag": "HIGH"
      }
    ],
    "analyzed_at": "2026-04-10T14:35:00Z",
    "clinic": {
      "fp": "clinic_01JQMKXXXXX",
      "name": "Downtown Vet Clinic"
    }
  }
}

Diagnostic Types

TypeDescription
BLOOD_CBCComplete blood count
BLOOD_CHEMISTRYBlood chemistry panel
URINALYSISUrine analysis
COAGULATIONCoagulation panel
IMAGING_XRAYX-ray imaging study
IMAGING_USGUltrasound study
IMAGING_MRIMRI study
IMAGING_CTCT scan
POINT_OF_CAREPOCT rapid test

Result Flags

FlagDescription
NORMALWithin reference range
HIGHAbove reference range
LOWBelow reference range
CRITICAL_HIGHCritically elevated
CRITICAL_LOWCritically low

List Diagnostics by Patient

curl "https://api.vetigen.com/api/v1/patients/patient_01JQMKXXXXX/diagnostics" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

On this page