Skip to content
§Data API

Machine-readable NephTox

A versioned, read-only JSON projection of the whole citation-grounded catalog — 290 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 live API 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. Prefer one file? Download the whole catalog as CSV or JSON — free, no account needed.

Data

Bulk dataset export

Download the entire catalog as a single flat file — one row per agent, with its class and family, signature injury, full injury and nephron-segment sets, severity, era, onset window, citation-year bounds, and aggregate FAERS AKI reporting signal. Generated in your browser from the same client-safe projection the site uses.

290 agents·23 columns·290 deeply profiled
Format

Spreadsheet-ready (UTF-8 BOM, CRLF); multi-valued fields joined with “; ”.

Columns

  • id
  • name
  • brand
  • class
  • classFamily
  • classGroup
  • signatureInjury
  • injuryTypes
  • nephronSegments
  • severity
  • tier
  • yearApproved
  • onsetWindow
  • citations
  • firstYear
  • newestYear
  • faersAkiRor
  • faersAkiRorLo
  • faersAkiRorHi
  • faersAkiReports
  • faersTotalReports
  • faersAkiSignal
  • profiled

Terms

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

Endpoints

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

GET/api/v1/drugs

The full agent index — id, name, class + family, signature injury, nephron segment, severity, era, approval year, and FAERS AKI reporting signal. faersAkiSignal is null where openFDA returns no reports at all; false means queried with no significant signal, never merely unqueried.

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 + AKI report count + total report base), and top phenotype-nearest agents. faersAki.ror is raw disproportionality with no minimum report base; faersAkiSignal applies a 50-report floor. A ci95 lower bound above 1 with faersAkiSignal false means below the floor, and belowReportFloor says so.

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.1.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, "totalReports": 76218, "belowReportFloor": false },
    "phenotypeNeighbors": [{ "id": "arsenic-trioxide", "similarity": 0.758 }, ...],
    "links": { "profile": "/drugs/cisplatin", "api": "/api/v1/drugs/cisplatin" }
  }
}

FHIR R5 façade

The same catalog, re-serialized as HL7 FHIR R5 resources under /api/fhir — so EMR, formulary, and clinical-decision-support tooling can ingest NephTox in the interoperability language it already speaks. Responses are application/fhir+json; errors are a FHIR OperationOutcome.

GET/api/fhir/metadata

CapabilityStatement — the public conformance/discovery document describing every resource below. Open, no session required.

GET/api/fhir/Medication?name={q}

Agents as Medication resources — a searchset Bundle, name-filterable and _count-capped. GET /api/fhir/Medication/{id} for one.

GET/api/fhir/ClinicalUseDefinition?subject=Medication/{id}

A drug's documented kidney-injury associations as undesirable-effect definitions — each with the injury coding and its association tier as classification. GET …/{drugId}-{injuryId} for one (e.g. cisplatin-atn).

GET/api/fhir/DetectedIssue?implicated=Medication/{id}&implicated=Medication/{id}

Additive nephrotoxicity across a regimen — each kidney-injury signature that two or more implicated agents share, as a DetectedIssue whose evidence links back to the per-agent undesirable-effect definitions. Repeatable or comma-separated; at least two agents.

GET/api/fhir/CodeSystem/{id}

The injury (nephtox-injuries), nephron-segment, and injury-tier vocabularies as FHIR CodeSystems.

The CapabilityStatement is public; data and terminology resources share the /api/v1 private-beta gate — a 403 OperationOutcome without a beta session. No frequencyOfOccurrence is emitted — the atlas carries documented associations and their prominence, not incidence figures.

Integrating an EHR? A launch-initiated, read-only SMART on FHIR app opens the atlas to the anti-cancer agents on a patient's medication list — registration URLs, scopes, and privacy bounds are documented there.

MCP server

For AI assistants that speak the Model Context Protocol: a read-only server over the catalog export and the drug monographs, served from this site over Streamable HTTP with no key. Give an assistant the URL and it can search agents, pull a full profile, list every agent behind a signature, and cross-filter the catalog — each agent carrying its profile URL, and each full profile the PubMed identifiers it cites.

MCP/mcp

Streamable HTTP endpoint (also /api/mcp-server). Tools: search_agents, get_agent_profile, agents_by_signature, list_signatures, filter_agents. Stateless; no authentication; every response carries the not-medical-advice line and the FAERS caveat.

GET/llms.txt

Compact markdown index of the atlas for language models (llmstxt.org).

GET/llms-full.txt

Every catalog agent's monograph, the kidney-injury signatures and one-line syndrome summaries in one markdown file. Not included: the irAE organ atlas, the deep-dive essays and the /dosing tables.

Any client that takes a Streamable HTTP URL needs only https://nephtox.com/mcp — no key or header. Claude Code: claude mcp add --transport http nephtox https://nephtox.com/mcp.

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. Same citation-grounded seed as the site — see Methods & Provenance. Educational use; not medical advice. Attribute NephTox and cite the underlying primary sources, not the API, in scholarly work.