Free & Open Source

INAM Drugs API

A comprehensive REST API providing access to all INAM pharmaceutical products registered in Togo. Search, filter, and discover therapeutic solutions.

5
Endpoints
JSON
Response Format
Read
Only

100% Free

No costs, no subscriptions. Use the API freely for your projects.

Open Source

Source code available on GitHub. Contribute and improve!

Read-Only

Safe data access. No modifications or deletions possible.

Getting Started

Start making requests to the INAM Drugs API in seconds. No API key required.

Your First Request

fetch(
'https://inam-drugs-api.vercel.app/drugs'
).then(r => r.json())

Supported Methods

  • Fetch API
  • AJAX (XMLHttpRequest)
  • Axios, cURL, etc.

Response Format

[
  {
    "id": "1",
    "name": "Paracetamol 500mg",
    "price": 2500,
    "price_inam": 2000,
    "shape": "Tablet",
    "quantity": "1 blister",
    "dosage": "500mg",
    "therapy": "Pain Relief"
  }
]

API Reference

All available endpoints with request/response examples.

GET

/drugs

Retrieve all INAM registered drugs

GET https://inam-drugs-api.vercel.app/drugs
GET

/drugs?name=

Search for drugs by name

Query Parameters

name
Search term (e.g., "aspirin", "paracetamol")

Example Request

GET https://inam-drugs-api.vercel.app/drugs?name=test
GET

/drugs/:id

Retrieve a specific drug by its ID

Path Parameters

id
Unique drug identifier

Example Request

GET https://inam-drugs-api.vercel.app/drugs/1
GET

/drugs/therapies

Retrieve all available therapy categories

GET https://inam-drugs-api.vercel.app/drugs/therapies
GET

/drugs/therapy?=

Retrieve drugs filtered by therapy type

Query Parameters

therapy
Filter by therapy category (e.g., "Pain Relief", "Antibiotic")

Example Request

GET https://inam-drugs-api.vercel.app/drugs/therapy?=test

Drug Object Schema

{
  "id": String,
  "name": String,
  "price": Number,
  "price_inam": Number,
  "shape": String,
  "quantity": String,
  "dosage": String,
  "therapy": String
}

Integration Examples

See how to use the API in different programming languages.

JavaScript (Fetch)

fetch("https://inam-drugs-api.vercel.app/drugs")
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(err => console.error(err))

Python (Requests)

import requests

url = "https://inam-drugs-api.vercel.app/drugs"
response = requests.get(url)
data = response.json()
print(data)

cURL

curl -X GET \
  https://inam-drugs-api.vercel.app/drugs \
  -H "Accept: application/json"

Node.js (Axios)

const axios = require("axios");

axios
  .get("https://inam-drugs-api.vercel.app/drugs")
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

Frequently Asked Questions

How to get all drugs?⬇

Make a GET request to https://inam-drugs-api.vercel.app/drugs and you'll receive an array of all registered INAM drugs.

Can I search for specific drugs?⬇

Yes! Use the /drugs?name=aspirin endpoint to search by drug name. You can also filter by therapy using the /drugs/therapy?= endpoint.

Do I need authentication?⬇

No! The API is completely public and free to use. You can make requests directly from your browser or application without any API key or authentication.

Are there rate limits?⬇

Currently, there are no rate limits. However, we recommend using reasonable request patterns to ensure optimal performance for all users.

What data is included for each drug?⬇

Each drug includes: id, name, price, INAM price, shape (form), quantity, dosage, and therapy category. This comprehensive data helps you provide complete pharmaceutical information.

Is this API read-only?⬇

Yes, the API is read-only. You can query and retrieve pharmaceutical data, but cannot create, update, or delete records. This ensures data integrity and security.

Can I contribute to the project?⬇

The API is fully open source. You can contribute improvements, report bugs, or request features on the GitHub repository.

Built with v0