Open Data

Public JSON APIs for researchers, dashboards, and external knowledge integrations.

Last Updated: May 27, 2026Reviewed by: Andrei Dokukin, MD

Infrastructure & data referencePublic, no auth required

ASH publishes registry data as 8 free public CDN-cached JSON endpoints. No API key required. No rate limit. CORS enabled for browser fetches. Every PMID has been verified against PubMed E-utilities. Every ASH registry (conditions, compounds, RCTs, biographies, jurisdictions, research articles) has its own paginated endpoint.

Use case: external researchers polling growth toward our 10,000-article goal; knowledge-graph integrations; dashboards tracking registry expansion; reproducibility audits.

All endpoints return UTF-8 JSON. All endpoints set Cache-Control: public, s-maxage=3600, stale-while-revalidate=86400 for 1-hour CDN cache with graceful degradation. Errors return HTTP 400 with { error, message } shape.

GET/api/site-stats

Site Statistics

Live registry counts, progress toward the 10,000-article goal, condition Tier A/B/C breakdown, and link map.

Cache

1 hour ISR, public CDN-cacheable

CORS

Access-Control-Allow-Origin: *

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "registries": {
    "conditions": 199,
    "compounds": 155,
    "rcts": 104,
    "biographies": 68,
    "jurisdictions": 107
  },
  "researchArticles": 1083,
  "totalArtifacts": 1716,
  "longTermGoal": 10000,
  "progressPct": 10.83,
  "conditionTiers": { "A": 3, "B": 10, "C": 186 }
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/changelog

Changelog

Public history of major content sweeps, registry expansions, and editorial corrections. Mirrors the human-readable /changelog page.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–50, default 20
category — architecture | content | translation | registry | correction | infrastructure

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "entries": [
    {
      "date": "2026-05-27",
      "prRange": "PR #75",
      "title": "Marathon Wave 19 — ...",
      "summary": "...",
      "details": ["..."],
      "category": "registry"
    }
  ],
  "total": 20,
  "totalAvailable": 22
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/research-articles

Research Articles

Paginated access to the 1,300+ entry PMID-verified research-article library. Each entry has its PubMed Identifier verified against PubMed E-utilities.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–100, default 25
offset — ≥0, default 0
organ_system — case-insensitive substring (e.g. vascular, musculoskeletal)
year_min — filter by publication year (integer)
year_max — filter by publication year (integer)
tier — very-low | low | moderate | high

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "articles": [
    {
      "slug": "michalsen-2003-knee-oa",
      "pmid": "14644895",
      "title": "Effectiveness of leech therapy in osteoarthritis...",
      "authors": "Michalsen A, et al.",
      "year": 2003,
      "journal": "Ann Intern Med",
      "evidenceTier": "moderate",
      "studyType": "rct"
    }
  ],
  "total": 25,
  "totalAvailable": 1381
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/conditions

Conditions

Paginated access to all 199 condition entries with Tier A/B/C clinical-evidence framing and related-RCT counts.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–100, default 25
offset — ≥0, default 0
tier — A-FDA-cleared | B-clinical-evidence | C-investigational
category — 12 organ-system categories (case-insensitive)

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "conditions": [
    {
      "slug": "venous-congestion-flap",
      "name": "Venous Congestion in Microsurgical Reconstruction",
      "tier": "A-FDA-cleared",
      "category": "vascular",
      "icd10Codes": ["I87.2"],
      "_links": {
        "condition_page": "/en/condition/venous-congestion-flap",
        "related_rcts": 12
      }
    }
  ],
  "total": 25,
  "totalAvailable": 199
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/compounds

Compounds

Paginated access to all 155 compound entries: hirudin variants, salivary peptides, AMPs, ECM enzymes, etc. Includes molecular weight and target list.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–100, default 25
offset — ≥0, default 0
category — anticoagulant | antiplatelet | fibrinolytic | proteinase-inhibitor | anti-inflammatory | antimicrobial | vasodilator | ecm-enzyme | analgesic | other

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "compounds": [
    {
      "slug": "hirudin",
      "name": "Hirudin",
      "category": "anticoagulant",
      "evidenceTier": "established",
      "molecularWeightDa": 7000,
      "targets": ["thrombin (specific, irreversible)"],
      "_links": {
        "compound_page": "/en/compound/hirudin"
      }
    }
  ],
  "total": 25,
  "totalAvailable": 155
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/biographies

Biographies

Paginated access to 68 biography entries: investigators across antiquity through modern molecular biology. Includes era + publication count.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–100, default 25
offset — ≥0, default 0
era — ancient | medieval | 19th-century | early-20th | mid-20th | late-20th | contemporary

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "biographies": [
    {
      "slug": "haycraft-john-berry",
      "name": "John Berry Haycraft",
      "lifeSpan": "1857-1922",
      "era": "19th-century",
      "contribution": "Discovered hirudin (1884)",
      "publicationCount": 3,
      "_links": {
        "biography_page": "/en/biography/haycraft-john-berry"
      }
    }
  ],
  "total": 25,
  "totalAvailable": 68
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/jurisdictions

Jurisdictions

Paginated access to 107 jurisdiction entries: global regulatory survey with honest "unregulated" markers where applicable.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–100, default 25
offset — ≥0, default 0
region — north-america | europe | asia-pacific | latin-america | middle-east | africa | oceania

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "jurisdictions": [
    {
      "slug": "fda-usa",
      "name": "United States",
      "regulatoryAuthority": "FDA",
      "leechRegulatoryStatus": "cleared-K040187",
      "region": "north-america",
      "type": "national",
      "_links": {
        "jurisdiction_page": "/en/jurisdiction/fda-usa"
      }
    }
  ],
  "total": 25,
  "totalAvailable": 107
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

GET/api/rcts

Randomized Controlled Trials

Paginated access to 129+ RCT entries. 100% PMID-verified against PubMed (PMID Integrity Sprint Phase 1). Includes direct PubMed URL per entry.

Cache

1 hour ISR + stale-while-revalidate

CORS

Access-Control-Allow-Origin: *

Query parameters

limit — 1–100, default 25
offset — ≥0, default 0
grade — high | moderate | low | very-low (GRADE certainty rating)
status — completed | ongoing | preliminary
condition — condition-registry slug (e.g. venous-congestion-flap)

Sample response

Example only \u2014 live values may differ

{
  "asOf": "2026-05-27T12:00:00.000Z",
  "rcts": [
    {
      "slug": "michalsen-2003-knee-oa",
      "title": "Effectiveness of leech therapy in osteoarthritis...",
      "year": 2003,
      "pmid": "14644895",
      "pmidVerified": "2026-05-27",
      "condition": "knee-osteoarthritis",
      "design": "single-center RCT",
      "n": 51,
      "grade": "moderate",
      "status": "completed",
      "_links": {
        "rct_page": "/en/rct/michalsen-2003-knee-oa",
        "condition_page": "/en/condition/knee-osteoarthritis",
        "pubmed": "https://pubmed.ncbi.nlm.nih.gov/14644895/"
      }
    }
  ],
  "total": 25,
  "totalAvailable": 129
}

Counts shown above were captured at the time this page was written. For current live values, follow the “Try live” link below or call the endpoint directly.

Try live →

Editorial integrity contract

PMID verification. Every PubMed Identifier exposed by /api/research-articles has been resolved against PubMed E-utilities. RCT, condition, compound, and biography registries are 100% PMID-verified as of the 2026-05-27 PMID Integrity Sprint (phases 1\u20133). See PMID audit status for cycle-by-cycle audit results.
Tier-honest framing. Tier A clearance flag in /api/site-stats reflects only the FDA-cleared use (venous congestion in microsurgical reconstruction, K040187, 2004). Tier B/C are explicitly investigational across all responses.
Auditable change history. /api/changelog is generated from the same hand-maintained source as the human-readable /changelog page. Categories: registry, correction, architecture, content, translation, infrastructure.
No PII. No user data, no IP logging, no analytics. Only public aggregate statistics.
Stable URL structure. Endpoints under /api/* are versionless and stable. Breaking changes will be announced in /api/changelog with category correction and a 30-day deprecation window.

Usage examples

# Site-wide registry counts
curl -s https://www.hirudotherapysociety.org/api/site-stats | jq '.totalArtifacts'

# 10 most recent registry changes
curl -s 'https://www.hirudotherapysociety.org/api/changelog?limit=10&category=registry' | jq '.entries[].title'

# Page-2 of research articles, only musculoskeletal evidence
curl -s 'https://www.hirudotherapysociety.org/api/research-articles?limit=25&offset=25&organ_system=musculoskeletal' | jq '.articles[].title'

Transparency & Trust|PMID audit status|Research roadmap (10k goal)|Coverage map|GitHub (public source)

Open Data

Site Statistics

Changelog

Research Articles

Conditions

Compounds

Biographies

Jurisdictions

Randomized Controlled Trials

Editorial integrity contract

Usage examples

Related