FHIR © HL7.org  |  Server Home  |  XIG Home  |  XIG Stats  |  Server Source  |  FHIR  

FHIR IG Statistics: OperationDefinition/IDI-match

Packagehl7.fhir.us.identity-matching
Resource TypeOperationDefinition
IdIDI-match
FHIR VersionR4
Sourcehttp://hl7.org/fhir/us/identity-matching/https://build.fhir.org/ig/HL7/fhir-identity-matching-ig/OperationDefinition-IDI-match.html
URLhttp://hl7.org/fhir/us/identity-matching/OperationDefinition/IDI-match
Version2.0.0-ballot
Statusactive
Date2025-08-08T19:54:51+00:00
NameIDIMatch
TitleIDI Match Operation
Realmus
Authorityhl7
DescriptionThis extension of the $match operation is further constrained to meet the additional requirements found in this IG. One of the IDI Patient profiles outline in this guide (IDI-Patient, IDI-Patient-L0, IDI-Patient-L1, IDI-Patient-L2) SHALL be used as the input for the match request. An IDI-Match-Bundle will be returned to the requesting entity. This Bundle will contain the full URLs of the sourced information, an Organization resource, and any matched Patient resources.
Typetrue
Kindoperation

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: OperationDefinition IDI-match

URL: [base]/Patient/$idi-match

Input parameters Profile:IDI Match Input Parameters

Output parameters Profile:IDI Match Output Parameters

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INIDIPatient1..1Patient

A Patient resource that is being requested in the match operation. The requester must use one of the IDI Patient profiles for the resource in their submission.

OUTIDIMatchBundle1..1Bundle

When successful, a Bundle resource containing Patient resources of a high confidence match is returned to the requestor. In addition, an Organization resource of the responding entity will be included in the Bundle for error reporting purposes. When the responding server is unable to return a match, a response of 'No Match Found' will be returned.


Source

{
  "resourceType": "OperationDefinition",
  "id": "IDI-match",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "pa"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 2,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/identity-matching/ImplementationGuide/hl7.fhir.us.identity-matching"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/identity-matching/ImplementationGuide/hl7.fhir.us.identity-matching"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/us/identity-matching/OperationDefinition/IDI-match",
  "version": "2.0.0-ballot",
  "name": "IDIMatch",
  "title": "IDI Match Operation",
  "status": "active",
  "kind": "operation",
  "date": "2025-08-08T19:54:51+00:00",
  "publisher": "HL7 International / Patient Administration",
  "contact": [
    {
      "name": "HL7 International / Patient Administration",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/pafm"
        }
      ]
    }
  ],
  "description": "This extension of the $match operation is further constrained to meet the additional requirements found in this IG. One of the IDI Patient profiles outline in this guide (IDI-Patient, IDI-Patient-L0, IDI-Patient-L1, IDI-Patient-L2) SHALL be used as the input for the match request. An IDI-Match-Bundle will be returned to the requesting entity. This Bundle will contain the full URLs of the sourced information, an Organization resource, and any matched Patient resources.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "US"
        }
      ]
    }
  ],
  "code": "idi-match",
  "base": "http://hl7.org/fhir/us/identity-matching/OperationDefinition/IDI-match",
  "resource": [
    "Patient"
  ],
  "system": false,
  "type": true,
  "instance": false,
  "inputProfile": "http://hl7.org/fhir/us/identity-matching/StructureDefinition/idi-match-input-parameters",
  "outputProfile": "http://hl7.org/fhir/us/identity-matching/StructureDefinition/idi-match-output-parameters",
  "parameter": [
    {
      "name": "IDIPatient",
      "use": "in",
      "min": 1,
      "max": "1",
      "documentation": "A Patient resource that is being requested in the match operation. The requester must use one of the IDI Patient profiles for the resource in their submission.",
      "type": "Patient"
    },
    {
      "name": "IDIMatchBundle",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "When successful, a Bundle resource containing Patient resources of a high confidence match is returned to the requestor. In addition, an Organization resource of the responding entity will be included in the Bundle for error reporting purposes. When the responding server is unable to return a match, a response of 'No Match Found' will be returned.",
      "type": "Bundle"
    }
  ]
}