REST API Reference
Programmatic access to B2B formulation calculations, density predictions, and chemical rules
Developer Integration Interface
The REST API allows corporate clients to connect internal ERP/LIMS software directly to PharmNode's physical calculations and compatibility engines, guaranteeing response latency under 20ms.
1. Authentication and Endpoint Protocol
All API requests require Bearer token authentication passed in the HTTP Authorization header. The API target base URL is hosted at https://api.pharmnode.com/v1. To prevent service degradation, requests are subject to strict rate limits depending on subscription tiers (Professional: 60 requests/min; Enterprise: unlimited).
2. Bulk Calculation Endpoint (/v1/flowability)
POST to /v1/flowability to calculate Carr's Index and Hausner's Ratio for a list of components. Request body must contain ingredient bulk and tapped density objects alongside concentration weights. The payload returns flowability classifications with 4 decimal places of mathematical accuracy.
POST /v1/flowability HTTP/1.1
Host: api.pharmnode.com
Authorization: Bearer <your_token>
Content-Type: application/json
{
"ingredients": [
{ "name": "Active API", "percent": 15.0, "bulk": 0.38, "tapped": 0.51 },
{ "name": "Avicel pH-102", "percent": 85.0, "bulk": 0.29, "tapped": 0.41 }
]
}3. Chemical Compatibility Screening (/v1/compatibility)
POST to /v1/compatibility to run active-excipient checks. The endpoint evaluates combinations across 35 chemical classes, returning compatibility percentages, risk scores, and detailed logs for known conflicts (like amino-sugar browning or allergens).
Public Endpoint Registry
Summary of API endpoints and targeted processing latency profiles
| Method | Endpoint Path | Target Latency | Description |
|---|---|---|---|
| GET | /v1/ingredients | 15ms | List standard and custom raw materials |
| POST | /v1/flowability | 20ms | Calculate bulk/tapped composite densities, Carr & Hausner |
| POST | /v1/compatibility | 20ms | Evaluate chemical conflicts across 35 classes |
| GET | /v1/recipes/:id | 10ms | Fetch stored recipe structure and metadata |
| POST | /v1/recipes/gmp-export | 150ms | Generate validated GMP PDF technical spec sheets |