Skip to main content
curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "success": true,
  "data": {
    "suggestions": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.95,
        "match_type": "prefix"
      },
      {
        "concept_id": 4000678,
        "concept_name": "Diabetes mellitus",
        "concept_code": "73211009",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.92,
        "match_type": "prefix"
      },
      {
        "concept_id": 435216,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.90,
        "match_type": "partial"
      },
      {
        "concept_id": 4174977,
        "concept_name": "Diabetic retinopathy",
        "concept_code": "4855003",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.85,
        "match_type": "fuzzy"
      },
      {
        "concept_id": 443767,
        "concept_name": "Diabetic nephropathy",
        "concept_code": "127013003",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.83,
        "match_type": "fuzzy"
      }
    ],
    "total_suggestions": 5,
    "query": "diab"
  },
  "meta": {
    "request_id": "req_suggest_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}

Overview

Get intelligent concept suggestions for autocomplete functionality, based on partial text input. Uses advanced matching algorithms including fuzzy search and semantic similarity.

Query Parameters

query
string
required
Partial text input for suggestions (minimum 2 characters)
vocabulary
string
Limit suggestions to specific vocabulary
domain
string
Limit suggestions to specific domain
limit
integer
default:"10"
Maximum number of suggestions (max: 50)
curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "success": true,
  "data": {
    "suggestions": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "concept_code": "44054006",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.95,
        "match_type": "prefix"
      },
      {
        "concept_id": 4000678,
        "concept_name": "Diabetes mellitus",
        "concept_code": "73211009",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.92,
        "match_type": "prefix"
      },
      {
        "concept_id": 435216,
        "concept_name": "Type 1 diabetes mellitus",
        "concept_code": "46635009",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.90,
        "match_type": "partial"
      },
      {
        "concept_id": 4174977,
        "concept_name": "Diabetic retinopathy",
        "concept_code": "4855003",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.85,
        "match_type": "fuzzy"
      },
      {
        "concept_id": 443767,
        "concept_name": "Diabetic nephropathy",
        "concept_code": "127013003",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "match_score": 0.83,
        "match_type": "fuzzy"
      }
    ],
    "total_suggestions": 5,
    "query": "diab"
  },
  "meta": {
    "request_id": "req_suggest_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2"
  }
}
I