⌘K

Integration GuidesGuide

Catalog & mappings

Canonical Catalog, laboratory codes, biomarker mapping, lifecycle and what each channel sees.

On this page

Canonical Catalog

Each workspace has one Catalog. Partner API Programs and the Standard DTC storefront read projections of it; neither holds a separate copy.

Laboratory codes and biomarkers

  • Every orderable maps to the laboratory's own order code; an unmapped item cannot be transmitted and surfaces as a catalog-mapping exception.
  • Expected biomarkers link a test to entries in the canonical biomarker registry. Free text never creates a biomarker.
  • Result observations carry terminology codes only as the laboratory supplied them; missing codes are never derived.

Duplicates and lifecycle

  • Duplicating a test copies reusable details and biomarker selections but never the laboratory code mapping.
  • Active items are orderable where Fulfillment and clinical policy allow; paused items are visible but not orderable; archived items are hidden and restorable; only never-used items can be deleted.

What each channel sees

  • Partner API — items in Programs granted to the key, via GET /v1/programs/{programId}/catalog.
  • Standard DTC — only storefront-eligible tests: active, visible, available and with a storefront address.

Related resources