API Quick Start

The Pharazi.ai API lets you run pharmacokinetic calculations programmatically. Available on Pro and Enterprise plans.

Authentication

All API requests require a Bearer token. Get your API key from Settings → API.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.pharazi.ai/v1/tools

Your First Request

GET /api/v1/tools

{
  "data": [
    {
      "slug": "clearance-calculator",
      "name": "Clearance Calculator",
      "category": "pk-parameters"
    }
  ]
}

POST /api/v1/calculate/clearance-calculator
Content-Type: application/json

{
  "dose": 500,
  "auc": 25,
  "bioavailability": 0.85
}

{
  "result": {
    "clearance": 17.0,
    "unit": "L/h"
  },
  "interpretation": "Clearance of 17.0 L/h is within the typical range..."
}

Rate Limits

Rate limit headers in every response:

• X-RateLimit-Limit — your total allowance
• X-RateLimit-Remaining — requests left
• X-RateLimit-Reset — reset timestamp (Unix epoch)

Error Handling

All errors return consistent JSON:

{
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Parameter 'dose' must be a positive number"
  }
}