FHIR CodeSystem/$find-matches for property search
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({resourceType: '<string>', parameter: [{}]})
};
fetch('https://fhir.omophub.com/fhir/{version}/CodeSystem/$find-matches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url 'https://fhir.omophub.com/fhir/{version}/CodeSystem/$find-matches' \
--header 'Content-Type: application/json' \
--data '
{
"resourceType": "<string>",
"parameter": [
{}
]
}
'import requests
url = "https://fhir.omophub.com/fhir/{version}/CodeSystem/$find-matches"
payload = {
"resourceType": "<string>",
"parameter": [{}]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"resourceType": "Parameters",
"parameter": [
{
"name": "match",
"part": [
{
"name": "concept",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "44054006",
"display": "Type 2 diabetes mellitus"
}
}
]
},
{
"name": "match",
"part": [
{
"name": "concept",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}
}
]
}
]
}
FHIR CodeSystem/$find-matches for property search
Find OMOP concepts by property criteria using FHIR $find-matches - search by ingredient, dose form, lab method, or other coded property attributes.
FHIR CodeSystem/$find-matches for property search
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({resourceType: '<string>', parameter: [{}]})
};
fetch('https://fhir.omophub.com/fhir/{version}/CodeSystem/$find-matches', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));curl --request POST \
--url 'https://fhir.omophub.com/fhir/{version}/CodeSystem/$find-matches' \
--header 'Content-Type: application/json' \
--data '
{
"resourceType": "<string>",
"parameter": [
{}
]
}
'import requests
url = "https://fhir.omophub.com/fhir/{version}/CodeSystem/$find-matches"
payload = {
"resourceType": "<string>",
"parameter": [{}]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"resourceType": "Parameters",
"parameter": [
{
"name": "match",
"part": [
{
"name": "concept",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "44054006",
"display": "Type 2 diabetes mellitus"
}
}
]
},
{
"name": "match",
"part": [
{
"name": "concept",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}
}
]
}
]
}
Overview
Returns concepts matching a set of property criteria. This is a reverse lookup — “find me concepts with these characteristics” rather than “look up this specific code.” Maps to OMOPHub’s search capabilities with domain, vocabulary, and concept class filters.Contract Parameters
string
default:"r4"
string
required
Must be
Parameters.array
required
FHIR parameters containing optional
system and repeatable composite
property values.Request
curl -X POST "https://fhir.omophub.com/fhir/r4/CodeSystem/\$find-matches" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/fhir+json" \
-d '{
"resourceType": "Parameters",
"parameter": [
{ "name": "system", "valueUri": "http://snomed.info/sct" },
{
"name": "property",
"part": [
{ "name": "code", "valueCode": "domain-id" },
{ "name": "value", "valueCode": "Condition" }
]
}
]
}'
$find-matches requires structured property parameters with code and
value parts. Use POST with a FHIR Parameters body - GET query strings cannot
express this structure.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
system | uri | No | Code system to search within |
property | composite | No (repeatable) | Property criteria (code + value pair). If omitted, returns a broad search. |
Supported Property Codes
| Property Code | Description | Example Value |
|---|---|---|
domain-id | OMOP domain | Condition, Drug, Measurement, Procedure |
vocabulary-id | OMOP vocabulary | SNOMED, ICD10CM, LOINC, RxNorm |
concept-class-id | Concept class | Clinical Finding, Ingredient, Lab Test |
standard-concept | Standard status | S (Standard), C (Classification) |
concept-name | Text search | diabetes, myocardial |
Response
Response Fields
string
Always
Parameters.array
One parameter per match.
string
Always
match.array
Contains the matched concept.
string
Always
concept.object
Matched Coding with
system, code, and display.{
"resourceType": "Parameters",
"parameter": [
{
"name": "match",
"part": [
{
"name": "concept",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "44054006",
"display": "Type 2 diabetes mellitus"
}
}
]
},
{
"name": "match",
"part": [
{
"name": "concept",
"valueCoding": {
"system": "http://snomed.info/sct",
"code": "73211009",
"display": "Diabetes mellitus"
}
}
]
}
]
}
Was this page helpful?