10Developer / Partner API

One API for the formulary, GeneRx, and outcomes.

The same engine that powers the Peptiter pilot is exposed as a REST API and via the Model Context Protocol (MCP) for partner clinics, EMR vendors, research collaborators, and AI agents. JSON, OAuth2, idempotent writes, full OpenAPI 3.1 spec, and an MCP tool suite. Currently in private beta — request access below.

Auth

OAuth2 client credentials

Per-clinic API client with scoped permissions.

Format

JSON · OpenAPI 3.1

Generate clients in any language. Spec versioned.

Protocol

MCP (Model Context Protocol)

Expose formulary, dosing, and outcomes as tools for AI assistants.

SLA

99.9% · 250ms p95

Multi-region; status page on request.

Endpoints

GET

/v1/formulary

List active compounds with dose ranges, regulatory status, and current dose-modifier rules.

GET

/v1/formulary/{key}

Full record for a single compound, including PGx modifiers and citations.

POST

/v1/generx/orders

Submit a GeneRx panel order for a patient (de-identified token + shipping address).

GET

/v1/generx/orders/{id}

Order status, lab receipt, and PGx report URL when available.

POST

/v1/recommendations

Submit intake + GeneRx variants; receive a PGx-adjusted starting-dose recommendation envelope.

POST

/v1/outcomes/events

Stream consented outcome events (weight, IGF-1, AE) into the aggregate cohort.

GET

/v1/changelog

Append-only log of formulary changes since a cursor; safe to poll.

POST /v1/recommendations

Request

{
  "compound": "semaglutide",
  "patient_token": "pt_2tHk9...",
  "intake": {
    "bmi": 33.4,
    "comorbidities": ["t2d"],
    "current_meds": []
  },
  "generx_variants": {
    "GLP1R_rs6923761": "AG",
    "GIPR_rs1800437": "GG",
    "MC4R_status": "wildtype",
    "CYP2D6_phenotype": "normal_metabolizer"
  }
}

200 OK

Response

{
  "recommendation_id": "rec_01HF...",
  "compound": "semaglutide",
  "starting_dose": "0.5 mg weekly",
  "rationale": [
    "GLP1R rs6923761 A allele carrier — faster initial titration permitted (changelog v0.5.0).",
    "No CYP2D6/CYP2C19 conflicts with submitted concurrent meds.",
    "BMI \u2265 30 — first-line GLP-1 indication."
  ],
  "titration": [
    { "week": "1-2",  "dose": "0.5 mg weekly" },
    { "week": "3-6",  "dose": "1.0 mg weekly" },
    { "week": "7-10", "dose": "1.7 mg weekly" },
    { "week": "11+",  "dose": "2.4 mg weekly" }
  ],
  "evidence_links": ["https://pubmed.ncbi.nlm.nih.gov/33567185/"],
  "review_required": true
}

Request access

Private beta. We onboard 2–3 partner clinics per month. Tell us your EMR, expected volume, and whether you need REST, MCP, or both — we'll send the OpenAPI spec, MCP manifest, sandbox credentials, and a short technical call.

Email api@peptiter.com

All endpoints documented above are intended specifications. Live API contract is published in the partner OpenAPI spec shared after onboarding.