> For the complete documentation index, see [llms.txt](https://docs.evitalrx.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.evitalrx.in/api-for-patient-app/medicines/search-products.md).

# Search Products

To search items with the Item Name (string), GTIN number of the product, or Salt-Composition(content).

#### [Explore Medicines Available in Staging](https://docs.evitalrx.in/getting-started-with-evitalrx.md#explore-medicines-available-in-staging)

## Search Products

<mark style="color:green;">`POST`</mark> [https://search.evitalrx.in/v1/patient/medicines/search\_v1](https://search.evitalrx.in/v1/doctor/medicines/search_v1)

If the Item is present in your inventory, then it will appear first.

#### Request Body

| Name                                                     | Type    | Description                                                                                                                                                                                                                                                                       |                                                                       |
| -------------------------------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| searchstring<mark style="color:red;">\*</mark>           | String  | <p>Search String input</p><p>It can be used in following ways.</p><p>By Item Name</p><p><code>"searchstring":"dolo"</code></p><p></p><p>By Content</p><p><code>"searchstring":"c,paraceta"</code></p><p></p><p>By GTIN Number</p><p><code>"searchstring":"89080034169"</code></p> |                                                                       |
| apikey<mark style="color:red;">\*</mark>                 | String  | Authentication token                                                                                                                                                                                                                                                              |                                                                       |
| <p>only\_approved<br><em>(Optional)</em></p>             | Boolean | <p>Filter search results to return only approved medicines.<br><br><strong>Default:</strong> <code>false</code><br><br><strong>Values:</strong> <code>true</code>                                                                                                                 | <code>false</code><br><br><code>"only\_approved": true</code><br></p> |
| <p>only\_inventory\_items<br><em>(Optional)</em><br></p> | String  | <p>Filter search results to return only products currently available in your inventory.<br><br><strong>Default:</strong> <code>"no"</code><br><br><strong>Values:</strong> <code>"yes"</code>                                                                                     | <code>"no"</code><br></p>                                             |

{% tabs %}
{% tab title="200 Products Retrieved Successfully" %}

```json
{
  "status_code": "1",
  "status_message": "SUCCESS",
  "datetime": "2026-09-25 11:48:47",
  "ng_version": "0.0.578",
  "data": {
    "search_type": "normal",
    "did_you_mean_result": [],
    "result": [
      {
        "accept_online_order": "yes",
        "cess_percentage": 0,
        "chemist_id": "QiN7ie8myrGKsFKHSS7FDg==",
        "directions": "0-0-0-0",
        "discontinued": "no",
        "discount_percentage": 0,
        "gst_percentage": 5,
        "ho_inventory_id": 0,
        "inventory_id": "QiN7ie8myrGKsFKHSS7FDg==",
        "item_category": "",
        "item_category_id": "QiN7ie8myrGKsFKHSS7FDg==",
        "item_lock": "no",
        "location": "",
        "lock_b2b_discount": "no",
        "lock_discount": "no",
        "max_quantity": 0,
        "medicine_id": "buuFcMkpKTXqj7rxexDKew==",
        "medicine_short_tag": "",
        "min_quantity": 0,
        "mrp": 32.12,
        "onboarding_medicine_name": "",
        "purchase_discontinued": "no",
        "quantity": 0,
        "sale_b2b_discount": 0,
        "sale_count": 0,
        "sale_discount": 0,
        "sell_in_loose": "yes",
        "batch": "",
        "batch_discount": 0,
        "expiry": "",
        "landing_price": 0,
        "price_to_retailer": 0,
        "skucode": "",
        "ci_is_nrx_required": "no",
        "ci_is_rx_required": "no",
        "ci_schedule_type": "H",
        "ci_non_sellable_quantity": 0,
        "sellable_quantity": 0,
        "available_for_patient": "yes",
        "content": "Paracetamol (650mg)",
        "dosage_type": "tablet",
        "hsn_code": "30049061",
        "image": "https://d2ffmswuyj0h1d.cloudfront.net/storage/medicines/692fb8a8c6f8d.jpg",
        "is_rx_required": 0,
        "is_nrx_required": "no",
        "popularity_score": 100,
        "medicine_category": "",
        "primary_category_id": "WDnmiqfF0hoba5uJ+BUfFw==",
        "manufacturer_name": "Micro Labs Ltd",
        "medicine_name": "Dolo 650 Tablet",
        "medicine_type": "drug",
        "pack_size": "15 Tablet",
        "packing_size": "1 Strip of  15 Tablet",
        "price": 32.13,
        "salt_content_id": "wnSfhg0Ybp7Nlo2mOVkoNQ==",
        "schedule_type": "H",
        "size": 15,
        "m_discontinued": "no",
        "requested_by_entity": "chemist",
        "brand_name": "Dolo",
        "mrp_per_unit": 2.14,
        "is_approved": "yes",
        "loose_quantity": 0,
        "strip_quantity": 0,
        "is_inventory_available": "no"
      },
    ]
  }
}
```

{% endtab %}

{% tab title="200: OK No Products found" %}

```json
{
    "status_code": "1",
    "status_message": "Success",
    "datetime": "2022-12-06 15:21:25",
    "data": {
        "did_you_mean_result": [],
        "result": []
    }
}
```

{% endtab %}

{% tab title="200: OK Validation Error" %}

```json
{
    "status_code": "0",
    "status_message": "\"Medicine Name\" length must be less than or equal to 20 characters long",
    "datetime": "2022-12-06 15:19:58",
    "data": null
}
```

{% endtab %}
{% endtabs %}

**List of available medicines in the staging environment:**

{% file src="/files/wHF4xVvM8zOXodnTUPT7" %}
