Suggest Concepts

curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&page_size=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&vocabulary_ids=SNOMED&domain_ids=Condition&page=1&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

params = {
    "query": "diab",
    "page": 1,
    "page_size": 5,
    "vocabulary_ids": "SNOMED",
    "domain_ids": "Condition"
}
response = requests.get(
    "https://api.omophub.com/v1/concepts/suggest",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params=params
)
data = response.json()

import { OMOPHub } from '@omophub/omophub-node';

const client = new OMOPHub();
const { data } = await client.concepts.suggest('diab', {
  page: 1,
  pageSize: 5,
  vocabularyIds: ['SNOMED'],
  domainIds: ['Condition'],
});

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

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

string

required

Partial text input for suggestions (minimum 2 characters, maximum 100 characters)

integer

default:"1"

Page number for pagination (1-based)

integer

default:"10"

Number of suggestions per page (max: 100)

string

Comma-separated list of vocabulary IDs to filter suggestions (e.g., “SNOMED,ICD10CM”)

string

Comma-separated list of domain IDs to filter suggestions (e.g., “Condition,Drug”)

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"

curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&vocabulary_ids=SNOMED&domain_ids=Condition&page=1&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

params = {
    "query": "diab",
    "page": 1,
    "page_size": 5,
    "vocabulary_ids": "SNOMED",
    "domain_ids": "Condition"
}
response = requests.get(
    "https://api.omophub.com/v1/concepts/suggest",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params=params
)
data = response.json()

import { OMOPHub } from '@omophub/omophub-node';

const client = new OMOPHub();
const { data } = await client.concepts.suggest('diab', {
  page: 1,
  pageSize: 5,
  vocabularyIds: ['SNOMED'],
  domainIds: ['Condition'],
});

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

API Reference

Search

Concepts

Concept Hierarchy

Mappings

FHIR Resolver

Relationships

Domains & Classifications

Vocabularies

Overview

Query Parameters

​Overview

​Query Parameters

Overview

Query Parameters