​
💊 Medicine APIs

The Medicine API bundle allows integration partners to access and interact with Localwell’s medicine catalogue. These endpoints support advanced search capabilities and intelligent stock-based substitute recommendations, essential for building pharmacy search and cart experiences.

​
📌 Available Endpoints

​
1. /v1/medicine/search_medicine

  • Search for medicines using name or barcode
  • Filters by pharmacy stock availability
  • Optimized for autosuggest and search bars

​
2. /v1/medicine/get_stock_substitutes

  • Get substitute medicines by composition match
  • Returns stock, batch, pricing, and expiry data
  • Can optionally filter only in-stock medicines

​
🔐 Authentication

All Medicine API requests must include:
  • Authorization: Bearer YOUR_BEARER_TOKEN (Bearer Token provided by Localwell)
  • x-pharmacy-id: YOUR_PHARMACY_ID (Pharmacy ID provided by Localwell)
Example: 
Authorization: Bearer YOUR_BEARER_TOKEN
x-pharmacy-id: 9