§Data API

Machine-readable NephTox

A versioned, read-only JSON projection of the whole citation-grounded catalog — 263 agents, their injury signatures, nephron targets, evidence bounds, phenotype neighbors, and aggregate FAERS reporting signals. Built for researchers, EMR/formulary tools, and other apps.

Private beta. The endpoints below are gated to approved beta members and authenticated by your NephTox session. Request access from your account — a key-based access tier for programmatic use is on the roadmap.

Endpoints

Base path /api/v1 · responses carry a schemaVersion (1.0.0).

GET/api/v1/drugs

The full agent index — id, name, class + family, signature injury, nephron segment, severity, era, approval year, and whether the agent carries a FAERS AKI reporting signal.

GET/api/v1/drugs/{id}

One agent in full: ranked injuries, nephron segments, citation-year bounds, aggregate FAERS AKI reporting odds ratio (point estimate + 95% CI + report count), and its top phenotype-nearest agents.

GET/api/v1/injuries

The 14-lesion kidney-injury taxonomy and the nephron-segment vocabulary the catalog is coded against.

Example response

GET /api/v1/drugs/cisplatin

{
  "schemaVersion": "1.0.0",
  "drug": {
    "id": "cisplatin",
    "name": "Cisplatin",
    "class": "Platinum agent",
    "classFamily": "Platinum agents",
    "signatureInjury": "atn",
    "nephronSegment": "proximal",
    "severity": "severe",
    "era": null,
    "yearApproved": 1978,
    "faersAkiSignal": true,
    "injuries": [{ "injury": "atn", "tier": "primary" }, ...],
    "nephronSegments": ["proximal", "distal", "vasculature"],
    "evidence": { "citations": 14, "firstYear": 1999, "newestYear": 2025 },
    "faersAki": { "ror": 3.35, "ci95": [3.195, 3.51], "reports": 1804 },
    "phenotypeNeighbors": [{ "id": "arsenic-trioxide", "similarity": 0.758 }, ...],
    "links": { "profile": "/drugs/cisplatin", "api": "/api/v1/drugs/cisplatin" }
  }
}

Terms

Aggregate data only — the API never exposes per-report FAERS term tables, and FAERS reporting odds ratios reflect disproportionate reporting, not incidence or proven causation. All values derive from the same citation-grounded seed as the site; see Methods & Provenance. Educational use; not medical advice. Please attribute NephTox and cite the underlying primary sources, not the API, in scholarly work.