Quickstart

Create an account, generate an API credential in the console, and extract your first codes. The SDK trades your client_id and client_secret for a token and refreshes it for you.

import { phenomlClient } from "phenoml";

const client = new phenomlClient({
  clientId: process.env.PHENOML_CLIENT_ID,
  clientSecret: process.env.PHENOML_CLIENT_SECRET,
  baseUrl: "https://experiment.app.pheno.ml",
});

const { codes } = await client.construe.codes.extract({
  text: "55F with chest pain and shortness of breath, ECG shows ST elevation.",
  system: { name: "ICD-10-CM", version: "2025" },
  config: { include_citations: true },
});

// Each code carries a citation back to the exact span it came from.

Base URL. The shared sandbox is experiment.app.pheno.ml. Dedicated plans get a private instance; pass it as baseUrl.