@sequoiaport/codes

@sequoiaport/codes

Official TypeScript/JavaScript SDK for the Sequoia Codes API — a unified API for medical code search and lookup.

Query ICD-10, CPT, HCPCS, SNOMED CT, LOINC, and RxNorm codes through a single client. The SDK also covers LCD/NCD coverage guidelines, Life Expectancy actuarial tables (CDC/CMS WCMSA standard), and a clinical orchestrator for cross-system operations like coverage checks and diagnosis-to-procedure mapping.

• Fully typed with Zod-validated responses
• Supports both ESM and CommonJS
• Includes agent skills for AI coding assistants

Installation

npm install @sequoiaport/codes

Quick Start

import { SequoiaCodesClient } from "@sequoiaport/codes";

const client = new SequoiaCodesClient({
  apiKey: process.env.SEQUOIA_CODES_API_KEY!,
});

// Search for ICD-10 codes
const icd10Results = await client.icd10.searchCode({ query: "diabetes type 2" });
console.log(icd10Results.results);

// Look up a specific SNOMED code
const snomedCode = await client.snomed.identifyCode({ code: "73211009" });
console.log(snomedCode.concept);

// Search for CPT procedures
const cptResults = await client.cpt.searchCode({ query: "knee replacement" });
console.log(cptResults.results);

API Categories

Coding Systems

• client.snomed - SNOMED CT clinical terminology
• client.icd10 - ICD-10 diagnosis codes
• client.cpt - CPT procedure codes
• client.hcpcs - HCPCS procedure codes
• client.loinc - LOINC laboratory test codes
• client.rxnorm - RxNorm drug/medication codes

Actuarial / Reference Data

• client.lifeExpectancy - CDC/CMS WCMSA life expectancy actuarial tables

Guidelines

• client.lcd - Local Coverage Determinations
• client.ncd - National Coverage Determinations

Orchestrators

• client.clinical - Cross-engine clinical operations
• client.system - System health and async results

Examples

SNOMED

// Hybrid search
const results = await client.snomed.searchCode({
  query: "heart failure",
  limit: 10,
});

// Lookup by code
const concept = await client.snomed.identifyCode({ code: "84114007" });

ICD-10

// Search with billing filter
const results = await client.icd10.searchCode({
  query: "diabetes",
  billingOnly: true,
  limit: 20,
});

// Lookup specific code
const code = await client.icd10.identifyCode({ code: "E11.9" });

// Get all chapters
const chapters = await client.icd10.getChapters();

CPT/HCPCS

// Search CPT codes
const cptResults = await client.cpt.searchCode({ query: "colonoscopy" });

// Get cost/RVU data
const cost = await client.cpt.getCost({ code: "45378" });

// Get ICD-10 linking terms
const linkTerms = await client.cpt.linkIcd10({ code: "99213" });

// Search HCPCS codes
const hcpcsResults = await client.hcpcs.searchCode({ query: "wheelchair" });

LOINC

// Search lab tests
const results = await client.loinc.searchCode({ query: "glucose" });

// Lookup specific code
const test = await client.loinc.identifyCode({ code: "2345-7" });

// Get panel members
const panel = await client.loinc.getPanelMembers({ code: "24323-8" });

RxNorm

// Search drugs
const results = await client.rxnorm.searchCode({ query: "metformin" });

// Lookup by NDC
const ndcResult = await client.rxnorm.identifyCode({
  type: "ndc",
  code: "0002-4112-01",
});

// Lookup by RXCUI
const rxcuiResult = await client.rxnorm.identifyCode({
  type: "rxcui",
  code: "861004",
});

// Get active ingredients
const ingredients = await client.rxnorm.getIngredients({ rxcui: "861004" });

Guidelines (LCD/NCD)

// Search LCD guidelines
const lcdResults = await client.lcd.searchGuidelines({ query: "MRI" });

// Lookup specific LCD
const lcd = await client.lcd.identifyGuideline({ id: "L33288" });

// Search NCD guidelines
const ncdResults = await client.ncd.searchGuidelines({ query: "oxygen" });

// Lookup NCD by section
const ncd = await client.ncd.identifyGuideline({ section: "220.6" });

Life Expectancy

// Look up life expectancy for a 65-year-old
const le = await client.lifeExpectancy.lookupByAge({ age: 65 });
console.log(le.result?.ex); // e.g. 19.09 years

// Batch lookup for multiple ages
const batch = await client.lifeExpectancy.lookupBatch({
  ages: [30, 50, 70],
  gender: "female",
});

// Get the full actuarial life table
const table = await client.lifeExpectancy.getTable({ gender: "total" });

// Get active dataset version metadata
const version = await client.lifeExpectancy.getVersion();

// Health check
const health = await client.lifeExpectancy.health();

Clinical Orchestrator

// Check coverage for CPT + ICD-10 pair
const coverage = await client.clinical.checkCoverage({
  cpt_code: "99213",
  icd10_code: "E11.9",
});

// Map diagnosis to procedures
const procedures = await client.clinical.getProceduresForDiagnosis({
  icd10_code: "M17.11",
});

// Get metadata from all engines
const metadata = await client.clinical.getMetadata();

System

// Health check
const health = await client.system.health();

// Get async result
const result = await client.system.getResult({ request_id: "abc123" });

Configuration

const client = new SequoiaCodesClient({
  apiKey: "your-api-key",
  baseUrl: "https://api.sequoiacodes.com", // optional
  version: "v1", // optional
});

Error Handling

import { SequoiaCodesClient, CodesApiError } from "@sequoiaport/codes";

try {
  const result = await client.icd10.searchCode({ query: "test" });
} catch (error) {
  if (error instanceof CodesApiError) {
    console.error(`API Error ${error.status}: ${error.message}`);
    console.error(`Action: ${error.action}`);
  }
}

TypeScript Support

All methods are fully typed. Import types as needed:

import type {
  SnomedConcept,
  Icd10Code,
  CPTCode,
  LoincCode,
  RxnormDrug,
  LifeExpectancyResult,
  LEVersionInfo,
} from "@sequoiaport/codes";

Agent Skills

This SDK includes agent skills compatible with the Vercel Agent Skills ecosystem. Skills give AI coding agents the knowledge to use the Sequoia Codes SDK for medical coding tasks.

Install Skills

# Install all skills from this repo
npx skills add sequoia-port/codes

# Or install individual skills
npx skills add sequoia-port/codes --skill icd10-codes
npx skills add sequoia-port/codes --skill cpt-codes
npx skills add sequoia-port/codes --skill snomed-codes
npx skills add sequoia-port/codes --skill hcpcs-codes
npx skills add sequoia-port/codes --skill loinc-codes
npx skills add sequoia-port/codes --skill rxnorm-codes
npx skills add sequoia-port/codes --skill life-expectancy

Available Skills

Skill	Description
icd10-codes	ICD-10 diagnosis code search and lookup
cpt-codes	CPT procedure code search, lookup, cost/RVU, and ICD-10 linking
snomed-codes	SNOMED CT clinical terminology search and lookup
hcpcs-codes	HCPCS Level II code search, lookup, and cost
loinc-codes	LOINC laboratory test code search, lookup, and panel members
rxnorm-codes	RxNorm drug code search, NDC/RXCUI lookup, and ingredients
life-expectancy	CDC/CMS life expectancy actuarial table lookups for WCMSA calculations

Skills are compatible with Claude Code, Cursor, GitHub Copilot, Gemini, and 17+ other agents.

License

MIT