API examples for common MIRA workflows.

Copyable TypeScript examples for the flows developers usually ask about first: finding patients, writing patient resources, opening encounters, and adding billable charge items.

import {
  FhirDeHttpError,
  createFhirDeClient,
} from '@polaris/sdk/fhir'
import type { FhirResource, FhirTransport } from '@polaris/sdk/fhir'

const baseUrl = 'https://aidbox.example.com/fhir'

const transport: FhirTransport = {
  async request(method, path, init) {
    const normalizedPath = path.startsWith('/') ? path : `/${path}`
    const url = new URL(`${baseUrl.replace(/\/$/, '')}${normalizedPath}`)

    if (init?.query) {
      for (const [key, value] of Object.entries(init.query)) {
        const values = Array.isArray(value) ? value : [value]
        for (const item of values) url.searchParams.append(key, item)
      }
    }

    const res = await fetch(url, {
      method,
      headers: {
        'Content-Type': 'application/fhir+json',
        Accept: 'application/fhir+json',
        Authorization: `Bearer ${process.env.AIDBOX_TOKEN}`,
        ...init?.headers,
      },
      body: init?.body == null ? undefined : JSON.stringify(init.body),
    })

    const body = res.status === 204 ? null : await res.json().catch(() => null)
    if (!res.ok) throw new FhirDeHttpError(res.status, body)
    return body
  },
}

const client = createFhirDeClient({ baseUrl, transport })

async function putResource<T extends FhirResource>(resource: T): Promise<T> {
  if (!resource.id) throw new Error('PUT requires resource.id')
  return await transport.request(
    'PUT',
    `/${resource.resourceType}/${resource.id}`,
    { body: resource }
  ) as T
}

import { buildPatient } from '@polaris/fhir-de'

const patient = buildPatient({
  id: 'pat-001',
  firstName: 'Anna',
  lastName: 'Müller',
  birthDate: '1985-04-12',
  gender: 'female',
  kvid10: 'A123456789',
  address: {
    line: ['Hauptstraße 1'],
    city: 'München',
    postalCode: '80331',
    country: 'DE',
  },
})

await putResource(patient)

import {
  SYSTEM_EBM,
  SYSTEM_GOAE,
  buildChargeItem,
} from '@polaris/fhir-de'

const ebm03000 = buildChargeItem({
  id: 'charge-ebm-03000-001',
  status: 'billable',
  code: {
    system: SYSTEM_EBM,
    code: '03000',
    display: 'Versichertenpauschale',
  },
  subject: { reference: 'Patient/pat-001' },
  context: { reference: 'Encounter/enc-2026-04-27-001' },
  occurrenceDateTime: '2026-04-27T09:15:00+02:00',
  performer: [{ actor: { reference: 'Practitioner/prac-001' } }],
  quantity: { value: 1 },
})

const goae1 = buildChargeItem({
  id: 'charge-goae-1-001',
  status: 'billable',
  code: {
    system: SYSTEM_GOAE,
    code: '1',
    display: 'Beratung',
  },
  subject: { reference: 'Patient/pat-001' },
  context: { reference: 'Encounter/enc-2026-04-27-001' },
  occurrenceDateTime: '2026-04-27T09:20:00+02:00',
  performer: [{ actor: { reference: 'Practitioner/prac-001' } }],
  quantity: { value: 1 },
  factorOverride: 2.3,
})

await putResource(ebm03000)
await putResource(goae1)

import {
  AnonymizedPrompt,
  routeRequest,
  scanForPii,
  NoopAuditStore,
} from '@polaris/sdk/llm'

// Construct a PII-safe prompt (must have been anonymized before calling from())
const prompt = AnonymizedPrompt.from({ anonymizedText: 'Diagnose: Hypertonie' })

// Check text for PII before constructing an AnonymizedPrompt
const piiResult = scanForPii('Patient: Max Mustermann, geb. 01.01.1980')
if (piiResult.hasPii) {
  // Anonymize or redact before proceeding
  console.log('PII detected:', piiResult.matches)
}

// Route a request through the LLM gateway
const auditStore = new NoopAuditStore()
const result = await routeRequest(
  { intentId: 'summarize-encounter', prompt },
  { auditStore }
)