Skip to main content

​
Overview

Marmar exposes a pragmatic FHIR v4 surface so tenants can synchronize clinical data without bespoke transformers. We currently support the following resource types in both directions:
  • Patient
  • MedicationStatement
  • MedicationRequest
  • Condition
  • AllergyIntolerance
  • Observation
  • Encounter
All endpoints require the tenant slug and API key via the X-Tenant-Code and X-API-Key headers and return standard FHIR JSON payloads (application/fhir+json).

​
Submit clinical bundles

Use POST /v1/fhir/$submit to ingest a FHIR Bundle (collection, batch, or transaction). Each entry is validated, normalized, and persisted. The response contains an OperationOutcome and per-resource counters so you can reconcile successes versus failures. 
curl -X POST https://cds.marmar.life/v1/fhir/$submit \
  -H "Content-Type: application/fhir+json" \
  -H "X-Tenant-Code: acme-oncology" \
  -H "X-API-Key: $MARMAR_API_KEY" \
  -d @bundle.json

​
Supported resources

  • Patient → updates the Marmar patient profile (external IDs are honoured).
  • MedicationStatement → upserts active medications that power assessment inputs.
  • MedicationRequest, Condition, AllergyIntolerance, Observation, Encounter → stored as raw FHIR JSON and retrievable through the search/read API.
If a resource fails validation, the response includes an OperationOutcome.issue with severity=error and the offending resource remains untouched.

​
Retrieve a resource

Use GET /v1/fhir/{resourceType}/{id} for direct reads. Marmar returns the latest copy of the resource in native FHIR form or an OperationOutcome with 404 if it is missing. 
curl -H "X-Tenant-Code: acme-oncology" \
  -H "X-API-Key: $MARMAR_API_KEY" \
  https://cds.marmar.life/v1/fhir/Patient/2b9f1b5a-...-6d7c

​
Search resources

GET /v1/fhir/{resourceType} returns a FHIR search bundle (type=searchset). Available filters vary per resource:
ResourceQuery params
Patientidentifier
MedicationStatementpatient, status
MedicationRequestpatient, status
Conditionpatient, status
AllergyIntolerancepatient, status
Observationpatient, category, code
Encounterpatient, status
curl -H "X-Tenant-Code: acme-oncology" \
  -H "X-API-Key: $MARMAR_API_KEY" \
  "https://cds.marmar.life/v1/fhir/Observation?patient=Patient/123&category=vital-signs"
The response includes total and individual bundle entries so you can page client-side. For larger data sets, apply filtering early or request resources in batches.

​
Error handling

  • Validation failures → 400 with OperationOutcome explaining the first failure.
  • Missing resources → 404 with OperationOutcome.
  • Authentication failures → 401 with OperationOutcome.
Always validate the returned OperationOutcome before assuming a bundle was fully processed.