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