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

# Suggest Concepts

## 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

<ParamField query="query" type="string" required>
  Partial text input for suggestions (minimum 2 characters, maximum 100 characters)
</ParamField>

<ParamField query="page" type="integer" default="1">
  Page number for pagination (1-based)
</ParamField>

<ParamField query="page_size" type="integer" default="10">
  Number of suggestions per page (max: 100)
</ParamField>

<ParamField query="vocabulary_ids" type="string">
  Comma-separated list of vocabulary IDs to filter suggestions (e.g., "SNOMED,ICD10CM")
</ParamField>

<ParamField query="domain_ids" type="string">
  Comma-separated list of domain IDs to filter suggestions (e.g., "Condition,Drug")
</ParamField>

<ParamField query="vocab_release" type="string">
  Vocabulary release version to query (e.g., "2025.1"). Defaults to latest release.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.omophub.com/v1/concepts/suggest?query=diab&page_size=5" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```bash cURL with filters theme={null}
  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"
  ```

  ```python Python theme={null}
  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()
  ```

  ```javascript JavaScript theme={null}
  const params = new URLSearchParams({
    query: 'diab',
    page: '1',
    page_size: '5',
    vocabulary_ids: 'SNOMED',
    domain_ids: 'Condition'
  });

  const response = await fetch(`https://api.omophub.com/v1/concepts/suggest?${params}`, {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  });
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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
      }
    }
  }
  ```
</ResponseExample>