$match

FHIR match operation is defined on Patient resource. Aidbox extends it to all resource types for which MDM is configured.
This operation finds all resources which match (i.e. are similar to) the given resource.
FHIR definition of the operation: http://hl7.org/fhir/OperationDefinition/Patient-match​
This operation translates to aidbox.mdm/match RPC call. The RPC has simpler syntax and you can adjust threshold values. Consider using it if you are not required to use FHIR syntax.
To use $match operation you need to set up MDM. Read the Aidbox MDM manual to learn how to use it.
Syntax
FHIR format
POST /fhir/<resourceType>/$match
​
resourceType: Parameters
parameter:
  - name: resource
    resource:
      # Resource in FHIR format to match against.
      # This must be the resource contents,
      # not a reference to another resource
  - name: onlyCertainMatches # This parameter is optional
    valueBoolean: true # or false
Aidbox format
POST /<resourceType>/$match?threshold=<threshold-value>
​
# Resource in Aidbox format to match against.
# This must be the resource contents,
# not a reference to another resource.
The threshold parameter is not required. It specifies minimum score for a match to be returned.
Examples
Find certain matches for the specified resource using FHIR format
POST /fhir/Patient/$match
​
resourceType: Parameters
parameter:
  - name: resource
    resource:
      name:
        - given:
            - John
          family: Smith-Johnson-Williams
      birthDate: "2000-01-01"
  - name: onlyCertainMatches
    valueBoolean: true
Example output
resourceType: Bundle
type: searchset
entry:
  - score: 0.99
    resource:
      name:
        - given:
            - John
          family: Smith-Johnson-Williams
      address:
        - city: London
      birthDate: "2000-01-01"
      resourceType: Patient
      id: pt-1
Find matches in AIdbox format with specific threshold
POST /Patient/$match?threshold=0.95
​
name:
  - given:
      - John
    family: Smith-Johnson-Williams
birthDate: "2000-01-01"
Example output
resourceType: Bundle
type: searchset
entry:
  - score: 0.99
    resource:
      name:
        - given:
            - John
          family: Smith-Johnson-Williams
      address:
        - city: London
      birthDate: "2000-01-01"
      resourceType: Patient
      id: pt-1
See also
MDM overview
aidbox.mdm/match

$validate

Observation/$lastn

Last modified 2mo ago