Open Data
Public JSON APIs for researchers, dashboards, and external knowledge integrations.
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.
/api/site-statsSite 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-06-06T12:00:00.000Z",
"registries": {
"conditions": 199,
"compounds": 201,
"rcts": 169,
"biographies": 68,
"jurisdictions": 155
},
"researchArticles": 10030,
"totalArtifacts": 10822,
"longTermGoal": 10000,
"progressPct": 100,
"goalReached": true,
"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.
/api/changelogChangelog
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 20category— 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.
/api/research-articlesResearch 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 25offset— ≥0, default 0organ_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.
/api/conditionsConditions
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 25offset— ≥0, default 0tier— A-FDA-cleared | B-clinical-evidence | C-investigationalcategory— 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.
/api/compoundsCompounds
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 25offset— ≥0, default 0category— 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.
/api/biographiesBiographies
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 25offset— ≥0, default 0era— 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.
/api/jurisdictionsJurisdictions
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 25offset— ≥0, default 0region— 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.
/api/rctsRandomized 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 25offset— ≥0, default 0grade— high | moderate | low | very-low (GRADE certainty rating)status— completed | ongoing | preliminarycondition— 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.
Editorial integrity contract
- PMID verification. Every PubMed Identifier exposed by
/api/research-articleshas 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-statsreflects 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/changelogis 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/changelogwith categorycorrectionand 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'