Patsiendi üldandmete teenus / Master Patient Index
1.5.0 - trial-use Estonia flag

Patsiendi üldandmete teenus / Master Patient Index - Downloaded Version 1.5.0 See the Directory of published versions

OperationDefinition: Patient legal relationships

Official URL: https://fhir.ee/mpi/OperationDefinition/patient-legal-relationship Version: 1.5.0
Active as of 2026-02-13 Computable Name: EEMPIPatientLegalRelationship

Operations that returns a list of valid (at the moment of the request) patient legal relationships based on data from Population Register (RR). Returns also custody types where applicable.

URL: [base]/Patient/$legal-relationship

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INpatient1..1Reference (Patient)

A direct resource reference to the patient resource.

INrelationship-type0..*codeIsiku suhte tüübid HL7 ja SNOMED (Required)

Relationship type. If missing, then all relationship types from bound ValueSet are queried.

INcustody-type0..*codeHooldusõiguse liik (Required)

Custody type. If missing, then only personal custody types ('H10', 'H11', 'H12') from bound ValueSet are queried.

INnocache0..1boolean

Specifies when the operation should ignore the value stored in the cache and should re-request data from the source. By default false.

OUTreturn1..1Bundle

Returns Bundle (with type 'collection') with Observation instances of EEMPISocialHistoryLegalRelationship profile. If multiple custody types are found between two persons, then multiple Observation instances for the same patient relationship are returned.

Notes:

Kohustuslik põhjendus

Antud päring nõuab x-road-issue HTTP päise lisamist. Põhejndus on nähtav patsiendile eesti.ee portaalis Andmejälgija kaudu.

Päring

GET [base]/Patient/$legal-relationship?{parameters}

Päringu parameetrite lisa-kirjeldus

  • relationship-type - suhte tüüp, mille kohta soovitakse märkusi pärida. Lubatud väärtused valueset-ist: https://fhir.ee/ValueSet/isiku-suhte-tyybid-hl7-ja-snomed
    • Näide: http://terminology.hl7.org/CodeSystem/v3-RoleClass|GUARD või http://snomed.info/sct|127848009
    • Ei ole lubatud määrata ilma koodisüsteemita.
  • custody-type - hooldusõiguse liik isikute vahel mida soovitakse pärida. Lubatud väärtused valueset-ist: https://fhir.ee/ValueSet/hooldusoiguse-liik
    • Näide: H20 (täielik isikuhooldusõigus)
    • Lubatud määrata ilma koodisüsteemita.

Sama parameetri võib esineda mitu korda (rakendatud OR loogika).

Näide päringust

GET [base]/Patient/$legal-relationship?patient=Patient/8356&relationship-type=http://terminology.hl7.org/CodeSystem/v3-RoleClass%7CGUARD&relationship-type=http://snomed.info/sct%7C127848009&custody-type=H20&custody-type=H10

Näide vastusest #1

{
  "resourceType" : "Observation",
  "id" : "LegalRelationship1",
  "meta" : {
    "profile" : [
      🔗 "https://fhir.ee/mpi/StructureDefinition/ee-mpi-socialhistory-legal-relationship"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Observation LegalRelationship1</b></p><a name=\"LegalRelationship1\"> </a><a name=\"hcLegalRelationship1\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-ee-mpi-socialhistory-legal-relationship.html\">EE MPI SocialHistory Legal Relationship</a></p></div><p><b>status</b>: Final</p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/observation-category social-history}\">Social history</span></p><p><b>code</b>: <span title=\"Codes:{http://snomed.info/sct 125676002}\">Person</span></p><p><b>subject</b>: <a href=\"Patient-pat1.html\">Indrek Bambus (official) Male, DoB: 1973-02-10 ( https://fhir.ee/sid/pid/est/ni#37302102711)</a></p><p><b>performer</b>: <a href=\"#hcLegalRelationship1/LegalRelationshipRelatedPerson1\">RelatedPerson Annika Tamm </a></p><p><b>value</b>: <span title=\"Codes:{https://fhir.ee/CodeSystem/hooldusoiguse-liik H10}\">Täielik isikuhooldusõigus</span></p><hr/><blockquote><p class=\"res-header-id\"><b>Generated Narrative: RelatedPerson #LegalRelationshipRelatedPerson1</b></p><a name=\"LegalRelationship1/LegalRelationshipRelatedPerson1\"> </a><a name=\"hcLegalRelationship1/LegalRelationshipRelatedPerson1\"> </a><p><b>identifier</b>: <code>https://fhir.ee/sid/pid/est/ni</code>/48501212710</p><p><b>patient</b>: <a href=\"Patient-pat1.html\">Indrek Bambus (official) Male, DoB: 1973-02-10 ( https://fhir.ee/sid/pid/est/ni#37302102711)</a></p><p><b>relationship</b>: <span title=\"Codes:{http://snomed.info/sct 72705000}\">Mother</span></p><p><b>name</b>: Annika Tamm </p></blockquote></div>"
  },
  "contained" : [
    {
      "resourceType" : "RelatedPerson",
      "id" : "LegalRelationshipRelatedPerson1",
      "identifier" : [
        {
          "system" : "https://fhir.ee/sid/pid/est/ni",
          "value" : "48501212710"
        }
      ],
      "patient" : {
        🔗 "reference" : "Patient/pat1"
      },
      "relationship" : [
        {
          "coding" : [
            {
              "system" : "http://snomed.info/sct",
              "code" : "72705000",
              "display" : "Mother"
            }
          ]
        }
      ],
      "name" : [
        {
          "family" : "Tamm",
          "given" : [
            "Annika"
          ]
        }
      ]
    }
  ],
  "status" : "final",
  "category" : [
    {
      "coding" : [
        {
          "system" : "http://terminology.hl7.org/CodeSystem/observation-category",
          "code" : "social-history",
          "display" : "Social history"
        }
      ]
    }
  ],
  "code" : {
    "coding" : [
      {
        "system" : "http://snomed.info/sct",
        "code" : "125676002",
        "display" : "Person"
      }
    ]
  },
  "subject" : {
    🔗 "reference" : "Patient/pat1"
  },
  "performer" : [
    {
      "reference" : "#LegalRelationshipRelatedPerson1"
    }
  ],
  "valueCodeableConcept" : {
    "coding" : [
      {
        "system" : "https://fhir.ee/CodeSystem/hooldusoiguse-liik",
        "code" : "H10",
        "display" : "Täielik isikuhooldusõigus"
      }
    ]
  }
}

Näide vastusest #2

{
  "resourceType" : "Observation",
  "id" : "LegalRelationship2",
  "meta" : {
    "profile" : [
      🔗 "https://fhir.ee/mpi/StructureDefinition/ee-mpi-socialhistory-legal-relationship"
    ]
  },
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: Observation LegalRelationship2</b></p><a name=\"LegalRelationship2\"> </a><a name=\"hcLegalRelationship2\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Profile: <a href=\"StructureDefinition-ee-mpi-socialhistory-legal-relationship.html\">EE MPI SocialHistory Legal Relationship</a></p></div><p><b>status</b>: Final</p><p><b>category</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/observation-category social-history}\">Social history</span></p><p><b>code</b>: <span title=\"Codes:{http://snomed.info/sct 125676002}\">Person</span></p><p><b>subject</b>: <a href=\"Patient-pat1.html\">Indrek Bambus (official) Male, DoB: 1973-02-10 ( https://fhir.ee/sid/pid/est/ni#37302102711)</a></p><p><b>performer</b>: <a href=\"#hcLegalRelationship2/LegalRelationshipRelatedPerson2\">RelatedPerson Annika Tamm </a></p><hr/><blockquote><p class=\"res-header-id\"><b>Generated Narrative: RelatedPerson #LegalRelationshipRelatedPerson2</b></p><a name=\"LegalRelationship2/LegalRelationshipRelatedPerson2\"> </a><a name=\"hcLegalRelationship2/LegalRelationshipRelatedPerson2\"> </a><p><b>identifier</b>: <code>https://fhir.ee/sid/pid/est/ni</code>/48501212710</p><p><b>patient</b>: <a href=\"Patient-pat1.html\">Indrek Bambus (official) Male, DoB: 1973-02-10 ( https://fhir.ee/sid/pid/est/ni#37302102711)</a></p><p><b>relationship</b>: <span title=\"Codes:{http://terminology.hl7.org/CodeSystem/v3-RoleClass GUARD}\">guardian</span></p><p><b>name</b>: Annika Tamm </p></blockquote></div>"
  },
  "contained" : [
    {
      "resourceType" : "RelatedPerson",
      "id" : "LegalRelationshipRelatedPerson2",
      "identifier" : [
        {
          "system" : "https://fhir.ee/sid/pid/est/ni",
          "value" : "48501212710"
        }
      ],
      "patient" : {
        🔗 "reference" : "Patient/pat1"
      },
      "relationship" : [
        {
          "coding" : [
            {
              "system" : "http://terminology.hl7.org/CodeSystem/v3-RoleClass",
              "code" : "GUARD",
              "display" : "guardian"
            }
          ]
        }
      ],
      "name" : [
        {
          "family" : "Tamm",
          "given" : [
            "Annika"
          ]
        }
      ]
    }
  ],
  "status" : "final",
  "category" : [
    {
      "coding" : [
        {
          "system" : "http://terminology.hl7.org/CodeSystem/observation-category",
          "code" : "social-history",
          "display" : "Social history"
        }
      ]
    }
  ],
  "code" : {
    "coding" : [
      {
        "system" : "http://snomed.info/sct",
        "code" : "125676002",
        "display" : "Person"
      }
    ]
  },
  "subject" : {
    🔗 "reference" : "Patient/pat1"
  },
  "performer" : [
    {
      "reference" : "#LegalRelationshipRelatedPerson2"
    }
  ]
}