Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.omophub.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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.

​
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

ParameterTypeRequiredDescription
systemuriNoCode system to search within
propertycompositeNo (repeatable)Property criteria (code + value pair). If omitted, returns a broad search.

​
Supported Property Codes

Property CodeDescriptionExample Value
domain-idOMOP domainCondition, Drug, Measurement, Procedure
vocabulary-idOMOP vocabularySNOMED, ICD10CM, LOINC, RxNorm
concept-class-idConcept classClinical Finding, Ingredient, Lab Test
standard-conceptStandard statusS (Standard), C (Classification)
concept-nameText searchdiabetes, myocardial

​
Response

{
  "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"
          }
        }
      ]
    }
  ]
}