Back to Home

⚕️ RISP API Documentation

Complete guide to integrating with the Regulatory Information Sharing Platform

Introduction

The RISP API provides programmatic access to regulatory data across 55 African countries. This RESTful API enables developers to integrate RISP's comprehensive database into their applications.

Base URL

https://risp.auda-nepad.org/api/v1

Response Format

All responses are returned in JSON format with the following structure:

{ "success": true, "data": { ... }, "message": "Success", "timestamp": "2026-01-14T00:00:00Z" }

Authentication

The RISP API uses API keys for authentication. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

To obtain an API key, please contact the RISP team at info@risp.auda-nepad.org or generate one from your dashboard at https://risp.auda-nepad.org/products/api-connection.php

Authentication Example

curl -X GET "https://risp.auda-nepad.org/api/v1/products" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"

Products API

Access pharmaceutical product registrations across African countries.

GET /products

Retrieve a list of registered pharmaceutical products.

Query Parameters

Parameter Type Required Description
country string Optional Filter by country code (e.g., KE, NG, ZA)
status string Optional Filter by approval status
page integer Optional Page number (default: 1)
limit integer Optional Results per page (default: 50, max: 100)
GET /products/{id}

Retrieve details of a specific product by ID.

Medical Devices API

Access medical device registrations and regulatory information.

GET /devices

Retrieve a list of registered medical devices.

GET /devices/{id}

Retrieve details of a specific medical device.

Clinical Trials API

Access clinical trial registrations and status information.

GET /trials

Retrieve a list of clinical trials.

Trade Market Intelligence API

Access pharmaceutical trade data, import/export statistics, and regional market intelligence across African countries.

GET /trade-intelligence/summary

Retrieve trade summary data for pharmaceutical products.

Query Parameters

Parameter Type Required Description
country string Optional Filter by country code
region string Optional Filter by African region (East, West, North, South, Central)
year integer Optional Filter by year
hs_code string Optional Filter by HS code (Harmonized System)
GET /trade-intelligence/bilateral

Retrieve bilateral trade data between African countries.

GET /trade-intelligence/regional

Retrieve regional trade aggregations and dependencies.

Events API

Access regulatory events and conferences across Africa.

GET /events

Retrieve upcoming and past regulatory events.

Query Parameters

Parameter Type Required Description
country string Optional Filter by country
type string Optional Event type (conference, workshop, training, etc.)
from_date date Optional Start date filter (YYYY-MM-DD)

Organizations API

Access information about regulatory authorities and partner organizations.

GET /organizations

Retrieve a list of organizations.

GET /organizations/nras

Retrieve a list of National Regulatory Authorities across Africa.

Pharmacovigilance API

Access adverse event reports and pharmacovigilance data across Africa.

GET /pharmacovigilance

Retrieve pharmacovigilance reports.

POST /pharmacovigilance

Submit a new adverse event report.

Error Handling

The API uses standard HTTP status codes to indicate success or failure:

Status Code Meaning
200 Success
400 Bad Request - Invalid parameters
401 Unauthorized - Invalid or missing API key
404 Not Found - Resource doesn't exist
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error

Error Response Format

{ "success": false, "error": { "code": "INVALID_PARAMETER", "message": "The 'country' parameter must be a valid ISO country code" }, "timestamp": "2026-01-14T00:00:00Z" }

Rate Limits

To ensure fair usage and system stability, the following rate limits apply:

  • Standard tier: 1,000 requests per hour
  • Premium tier: 10,000 requests per hour
  • Enterprise tier: Custom limits available

Rate limit information is included in response headers:

X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 999 X-RateLimit-Reset: 1705190400

Need higher limits? Contact us at info@risp.auda-nepad.org to discuss enterprise options.

Support & Contact

For API support, feature requests, or partnership inquiries:

  • 📧 Email: info@risp.auda-nepad.org
  • 🌐 Website: https://risp.auda-nepad.org
  • 📚 API Documentation: https://risp.auda-nepad.org/api-documentation.php
  • 🔗 API Connection: https://risp.auda-nepad.org/products/api-connection.php