https://vetdrugs-pmi-api.vetdrugscalculator.com
Use the production custom domain for partner integrations.
API Reference
Endpoint guidance for real veterinary software integrations.
This page focuses on the partner-facing endpoints that matter in evaluation and production: calculation, drug search, full drug records, label search, and health.
Base URL, auth, and scope
Bearer API key
Authenticated endpoints require Authorization: Bearer vd_....
Dog and cat only
Commercial v1 supports canine and feline workflows only.
/api/calculate
Primary calculation endpoint for standard dosing, BSA-aware drugs, CRI workflows, and canine/feline fluid calculations.
Required
Requests must include a valid bearer API key.
species and weight_kg
Commercial v1 accepts dog or cat and a weight in kilograms.
Exact names matter
Use drug names returned by /api/drugs or /api/drugs-data.
{
"patient": {
"species": "dog",
"weight_kg": 20
},
"drugs": [
{
"drug_name": "Carprofen",
"concentration_id": 2
}
],
"settings": {
"checkInteractions": false
}
}{
"patient": {
"weight_kg": 20,
"species": "dog"
},
"calculations": [
{
"drug_name": "Carprofen",
"dose_per_kg": 2.2,
"total_dose": 44,
"volume": 0.88,
"instructions": "Give 0.88ml BID (2.2), SID (4.4)"
}
],
"metadata": {
"api_version": "2.5.0",
"drugs_processed": 1
}
}Build requests by workflow, not from one generic form
| Mode | What drives it | Key payload details |
|---|---|---|
| Standard | Weight-based medication dosing | patient, drug_name, optional concentration_id |
| BSA | Drug-driven BSA workflow | Still submitted to /api/calculate; the drug record determines the BSA path |
| CRI | Infusion-specific workflows | Requires shared CRI settings and may support editable load dose and CRI dose inputs |
| Maintenance Fluid | Fluid settings and maintenance formula | Uses maintenance-specific settings such as fluid time, deficit, losses, and related fields |
| Resuscitation / Surgical Fluid | Rate-based fluid workflows | Rate workflows are handled distinctly and should not be treated as generic concentration-based drugs |
/api/drugs and /api/drugs-data
Use /api/drugs for searchable medication discovery and /api/drugs-data when the
client needs fuller drug records, concentration metadata, or workflow-specific details.
GET /api/drugs?species=dog&search=car{
"species": "dog",
"count": 1,
"drugs": [
{
"name": "Carprofen",
"category": "NSAID",
"route": "BID (2.2), SID (4.4)",
"concentration_options": [
{
"id": 2,
"unit": "50mg/ml"
}
]
}
]
}/api/drug-labels/search
Search DailyMed labels from the same surface used for drug discovery and calculations. This is useful for product flows that need label context or links to drug label content.
GET /api/drug-labels/search?drug_name=carprofen/api/health
Operational health check for service availability, dataset readiness, and commercial scope confirmation.
{
"status": "healthy",
"version": "2.5.0",
"species_support": {
"dog": true,
"cat": true,
"avian": false,
"horse": false
}
}