Skip to main content

​
Overview

Get intelligent concept suggestions for autocomplete functionality, based on partial text input. Uses prefix matching on concept names to provide relevant suggestions.

​
Query Parameters

​
query
string
required
Partial text input for suggestions (minimum 2 characters, maximum 100 characters)
​
page
integer
default:"1"
Page number for pagination (1-based)
​
page_size
integer
default:"10"
Number of suggestions per page (max: 100)
​
vocabulary_ids
string
Comma-separated list of vocabulary IDs to filter suggestions (e.g., “SNOMED,ICD10CM”)
​
domain_ids
string
Comma-separated list of domain IDs to filter suggestions (e.g., “Condition,Drug”)
​
vocab_release
string
Vocabulary release version to query (e.g., “2025.1”). Defaults to latest release.
curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&page_size=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": [
    {
      "concept_id": 201826,
      "concept_name": "Type 2 diabetes mellitus",
      "concept_code": "44054006",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "valid_start_date": "2002-01-31",
      "valid_end_date": "2099-12-31",
      "invalid_reason": null
    },
    {
      "concept_id": 4000678,
      "concept_name": "Diabetes mellitus",
      "concept_code": "73211009",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "valid_start_date": "2002-01-31",
      "valid_end_date": "2099-12-31",
      "invalid_reason": null
    },
    {
      "concept_id": 435216,
      "concept_name": "Type 1 diabetes mellitus",
      "concept_code": "46635009",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "valid_start_date": "2002-01-31",
      "valid_end_date": "2099-12-31",
      "invalid_reason": null
    },
    {
      "concept_id": 4174977,
      "concept_name": "Diabetic retinopathy",
      "concept_code": "4855003",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "valid_start_date": "2002-01-31",
      "valid_end_date": "2099-12-31",
      "invalid_reason": null
    },
    {
      "concept_id": 443767,
      "concept_name": "Diabetic nephropathy",
      "concept_code": "127013003",
      "vocabulary_id": "SNOMED",
      "domain_id": "Condition",
      "concept_class_id": "Clinical Finding",
      "standard_concept": "S",
      "valid_start_date": "2002-01-31",
      "valid_end_date": "2099-12-31",
      "invalid_reason": null
    }
  ],
  "meta": {
    "request_id": "req_suggest_123",
    "timestamp": "2024-12-22T10:00:00Z",
    "vocab_release": "2025.2",
    "pagination": {
      "page": 1,
      "page_size": 5,
      "total_items": 47,
      "total_pages": 10,
      "has_next": true,
      "has_previous": false
    }
  }
}