API Documentation
Everything you need to integrate the Kisho Content API
Authentication
All API requests require authentication using a Bearer token in the Authorization header:
Authorization: Bearer kisho_live_your_api_keyAPI keys are prefixed with kisho_live_ for production or kisho_test_ for testing.
Base URL
https://kishomed.io/api/v1All endpoints are relative to this base URL.
Endpoints
/api/v1/diseasesList diseases with pagination and filtering
limit, offset, hasContent, isRare, hasTrials, inheritance, onset, prevalence/api/v1/diseases/searchSearch diseases by name, gene, or synonym
q, limit/api/v1/diseases/{mondoId}Get full disease report with all content sections
sections/api/v1/diseases/{mondoId}/summaryGet brief disease summary (overview only)
/api/v1/diseases/{mondoId}/sections/{section}Get specific content section
/api/v1/diseases/{mondoId}/pagsGet patient advocacy groups for a disease
limit, offset/api/v1/diseases/{mondoId}/assistanceGet patient assistance programs for a disease
status/api/v1/diseases/{mondoId}/orphan-drugsGet FDA orphan drug designations
/api/v1/diseases/{mondoId}/screeningGet newborn screening status
/api/v1/diseases/{mondoId}/phenotypesGet HPO clinical phenotypes
/api/v1/openapiGet OpenAPI 3.0 specification (no auth required)
/api/v1/healthAPI health check (no auth required)
Rate Limits
Rate limits vary by subscription tier:
| Tier | Monthly | Daily |
|---|---|---|
| Developer | 10,000 | 1,000 |
| Professional | 100,000 | 10,000 |
| Enterprise | Unlimited | Unlimited |
When you exceed your rate limit, the API returns a 429 Too Many Requests response.
Error Handling
The API uses standard HTTP status codes:
200Success400Bad Request - Invalid parameters401Unauthorized - Invalid or missing API key403Forbidden - Insufficient permissions404Not Found - Resource doesn't exist429Too Many Requests - Rate limit exceeded500Internal Server ErrorData Sources & Freshness
All data is sourced from authoritative, open-science databases and validated through automated QC pipelines. Check GET /api/v1/health for live freshness timestamps.
| Data Type | Source | Update Frequency |
|---|---|---|
| Disease Records | MONDO Disease Ontology | Per MONDO release |
| Clinical Phenotypes | Human Phenotype Ontology (HPO) | Monthly (1st) |
| Gene Associations | Monarch Initiative, HGNC, OMIM, OpenTargets | Per source release |
| Orphan Drug Designations | FDA Orphan Drug Database | Weekly (Sundays) |
| FDA Approved Drugs | Drugs@FDA (openFDA API) + CBER | Weekly (Sundays) |
| Clinical Trials | ClinicalTrials.gov API v2 | Weekly (Sundays) |
| Prevalence Data | Orphanet / Orphadata | Per Orphanet release |
| Newborn Screening | RUSP (HRSA Advisory Committee) | Monthly (1st) |
| News Intelligence | 25+ sources (FDA, NIH, STAT, Endpoints, etc.) | 3x daily |
| Policy Bills | LegiScan, OpenStates | Daily |
| Cross-References | OMIM, Orphanet, GARD, ICD-10, ICD-11, SNOMED | Per MONDO release |
Quality Assurance
- -HGNC gene validation — 44,748 approved gene symbols validated against HGNC database
- -AI fact-checking — Generated content cross-referenced against source data
- -3-tier QC validation — Hard stop, section regeneration, and editorial review tiers
- -Content versioning — Full audit trail with version history for every disease report
For live data freshness timestamps, call the GET /api/v1/health endpoint.
Need Help?
Our team is here to help you integrate the API successfully.