Skip to main content

JamMPI Quick Start

Prerequisites​

  • Docker + Docker Compose v2
  • PostgreSQL 14+ (included in Compose file)

1. Start JamMPI​

docker run -d \
  --name jammpi \
  -p 8081:8081 \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://db/mpi \
  -e SPRING_DATASOURCE_PASSWORD=yourpassword \
  ghcr.io/akhester-technologies/jammpi:1.0.0

2. Send your first $match​

POST /fhir/Patient/$match HTTP/1.1
Host: localhost:8081
Content-Type: application/fhir+json

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "resource",
    "resource": {
      "resourceType": "Patient",
      "name": [{"family": "Fernando", "given": ["Kamal"]}],
      "birthDate": "1985-03-14",
      "identifier": [{"system": "urn:br01.mrn", "value": "MRN123456"}]
    }
  }]
}

3. Read the response​

{
  "resourceType": "Bundle",
  "entry": [{
    "resource": {
      "id": "GOLDEN-00441",
      "extension": [
        {"url": "match-grade", "valueString": "certain"},
        {"url": "match-score", "valueDecimal": 0.97},
        {"url": "seen-at", "valueString": "BR01,BR03,BR07"}
      ]
    },
    "search": {"score": 0.97}
  }]
}

The id field is the golden record ID. JamBridge stamps this on every FHIR resource it writes.

Next: How matching works →