REFERENCE

Get a medicine

GET/v1/medicines/{ref}

One medicine. The answer always carries the medicine's current ID in your profile, even when you asked by an old ID.

Requestcurl
curl https://api.oushodh.dev/v1/medicines/MED-012933 \
  -H "Authorization: Bearer $OUSHODH_KEY"

Path parameter

ref is required.
  • refstring, required
    The medicine's ID in any profile, an old ID, or its UUID.

Response

A medicine object.

Response200
{
  "id": "MED-012933",
  "uuid": "01a1ba6f-f4d6-7143-ac84-9376f520eef8",
  "brand": "Napa",
  "category": null,
  "product_name": "Napa 500 mg Tablet",
  "product_image": null,
  "unit": null,
  "size": null,
  "price": 1.2,
  "price_per": "unit",
  "price_source": "dgda_price",
  "description_en": null,
  "description_bn": null,
  "dosage_form": "Tablet",
  "strength": "500 mg",
  "generic_name": "Paracetamol",
  "manufacturer": "Beximco Pharmaceuticals PLC.",
  "source_url": "https://medex.com.bd/brands/10452/napa-500-mg-tablet",
  "last_updated": "2026-11-09T15:27:34Z",
  "dgda_listed": true,
  "medicine_type": "allopathic"
}

Errors

Each error has a code and a message.
  • 401 unauthorizedNo key, an unknown key or a revoked key. The answer never says which.
  • 403 plan_expiredThe key's account has no active plan.
  • 404 not_foundNo medicine has that ID or UUID.
  • 429 rate_limitedMore requests in a minute than the key's plan allows.
  • 429 quota_exceededThe plan's requests for this month are used up.
  • 500 internalA fault on our side. The details go to our log, not the answer.