Skip to main content

ALETHEIA Safety API

Chemical safety data,
structured for machines.

1,886 compounds. 959 materials. 1,287 products. 2,325 fragrance ingredients. Regulatory classifications, exposure pathways, risk profiles, and 5D synthesis across IARC, EPA, EFSA, NTP, Prop 65, PubChem, and CompTox — delivered as clean JSON.

Get API Key Read Docs Try in Postman

Free tier: 500 lookups/day, no key required. Paid: Developer $79/mo or Pro $299/mo — save 17% on annual. 7-day Developer trial, no card. Powers 7 GeodesicNexus safety apps.

1,886 Compounds
959 Materials
1,287 Products
202 Regulatory Agencies
13 Risk Contexts
24,500+ Tests Passing

Built for

Who this is for

Four entry points. Each one links to a page that talks specifically to that audience — pricing examples, integration patterns, and the regulatory surfaces that matter for it.

Marketplaces

Screen every SKU automatically

Process 1,000–100,000+ new listings per day against Prop 65, REACH SVHC, EU Annex III, TSCA, and Health Canada CMP in batched calls. Architecture and pricing tuned for marketplace velocity.

For marketplaces → Consumer brands

Compliance before sourcing decisions

Pre-check ingredients and materials against IARC, EPA, EFSA, EU CLP, FDA, and OEHHA before product formulation locks. Categorized by personal-care, food-contact, baby, pets, household.

Browse use cases → Compliance & regulatory teams

Per-agency consensus, with disagreement preserved

The ALETHEIA synthesis layer surfaces where regulators agree and where they diverge on the same compound. Honest comparison vs. PubChem and EPA CompTox so you can verify our scope vs. yours.

Compare APIs → Developers

First call in under 2 minutes

Tabbed examples with curl, Python, and Node snippets. Postman workspace. SDKs on PyPI and npm. Free tier (500/day) requires no API key. 7-day Developer trial with no card.

Try the playground →

Use Cases

What developers build with this

🧴

Ingredient checkers

Look up cosmetic or food ingredients by name or CAS number. Surface regulatory flags automatically.

🐾

Pet safety apps

The database has species-specific risk contexts for dogs and cats across hundreds of household chemicals.

🏭

Product compliance

Batch-check materials or compounds against IARC, EU REACH, EPA classifications before sourcing decisions.

📊

Research tooling

Query regulatory disagreements across agencies. See where IARC, EPA, and EFSA diverge on the same compound.

🏥

Clinical decision support

Poison control lookups, exposure pathway data, and dose-response context for clinical tooling.

🌊

Environmental monitoring

Aquatic life risk contexts, degradation data, and persistence classifications for environmental work.

Quick Start

One request. Full safety context.

The free endpoint returns a complete risk synthesis for any compound. No key required.

Request 
# Free — no API key needed
curl https://api.aletheia.holisticquality.io/api/compound/hq-c-org-000001?context=human_adult

# With API key — unlocks full database
curl -H "X-API-Key: aletheia_live_..." \
  "https://api.aletheia.holisticquality.io/api/compounds?context=dog&risk_level=high"
Response (truncated) 
{
  "hq_id": "hq-c-org-000001",
  "name": "Glyphosate",
  "context": "human_adult",
  "risk_profile": {
    "magnitude": {
      "mean": 0.360,
      "confidence_interval_95": [0.082, 0.638],
      "source_positions": [
        { "source": "IARC", "value": 0.750, "weight": 0.680 },
        { "source": "EPA",  "value": 0.150, "weight": 0.820 }
      ]
    },
    "consensus": {
      "exists": false,
      "disagreement_magnitude": 0.422
    }
  },
  "interpretation": {
    "summary": "Regulatory agencies show substantial disagreement..."
  }
}

The free tier is real.

Individual lookups (/api/compound/:id, /api/product/:id, /api/material/:id) and the fragrance catalog (/api/fragrance) require no key, no account, no rate limit. That's 1,886 compounds, 1,287 products, 959 materials, and 2,325 fragrance ingredients available to anyone, permanently. Paid tiers unlock lists, batch, comparison, and regulatory/exposure queries. See what's included →

API Reference

Base URL: https://api.aletheia.holisticquality.io

Endpoints Contexts Response Format Risk Coordinates

Endpoints

Free endpoints require no API key. Paid endpoints require a Developer ($79/mo) or Pro ($299/mo) key via X-API-Key header.

Free — No Key Required

GET /api/compound/:id FREE

5D risk synthesis for a compound. Full regulatory consensus analysis.

Params: ?context=human_adult  |  ?all_contexts=true

GET /api/product/:id FREE

Full product detail — hazard summary, red/green flags, compounds of concern, materials, consumer guidance.

GET /api/material/:id FREE

Material detail — safety summary, compound linkage, thermal behavior, migration limits.

GET /api/compound/:id/contexts FREE

List all available risk contexts for a compound with descriptions.

GET /api/compound/:id/raw FREE

Raw compound JSON — full data file without synthesis processing.

GET /api/compound/cas/:cas FREE

Reverse lookup a compound by CAS registry number.

GET /api/fragrance FREE

Fragrance catalog — 2,325 ingredients across 29 chemical classes with safety priority scoring.

Sub-endpoints: /stats  |  /classes  |  /class/:name  |  /search?q=

GET /api/badge/:id FREE

Embeddable SVG risk badge for a compound. Drop into any page.

GET /api/health FREE

Health check. Also: /api/openapi — OpenAPI 3.1 spec.

Paid — API Key Required

GET /api/compounds API KEY

Paginated compound list with search, risk, type, and category filters.

Params: ?search= ?risk= ?context= ?type_filter= ?category_filter= ?page= ?limit=

GET /api/products API KEY

Paginated product list with search.

GET /api/materials API KEY

Paginated material list with search.

GET /api/compounds/batch?ids= API KEY

Fetch up to 20 compounds in a single request.

GET /api/compounds/compare?ids= API KEY

Side-by-side comparison of 2–5 compounds — risk deltas, LD50 ratios, regulatory agreement matrix, GHS diff.

GET /api/regulatory/:id API KEY

All regulatory classifications for a compound across IARC, EPA, EFSA, NTP, NIOSH, OSHA, EU, UNEP.

GET /api/regulatory/agencies   /api/regulatory/by-agency/:agency API KEY

Agency list with counts, or all compounds classified by a specific agency.

GET /api/found-in/:id   /api/found-in/categories   /api/found-in/by-category/:cat API KEY

Exposure source data — where compounds are found, by category.

GET /api/keys/status API KEY

Your key's tier, daily usage, remaining requests.

POST /api/keys/recover FREE

Recover a lost API key. Body: {"email": "you@example.com"}. Rate limited to 3/hour.

Valid Contexts (13)

Pass as ?context= query parameter. Not all compounds have all contexts — use /api/compound/:id/contexts to check. Aliases accepted (e.g. ?context=dog, ?context=pregnant, ?context=skin).

Response Format

{
  "hq_id": "hq-c-org-000001",
  "name": "Glyphosate",
  "context": "human_adult",

  "risk_profile": {
    "magnitude": {
      "mean": 0.360,
      "std_dev": 0.284,
      "confidence_interval_95": [0.082, 0.638],
      "source_positions": [
        {"source": "IARC", "value": 0.750, "weight": 0.680},
        {"source": "EPA",  "value": 0.150, "weight": 0.820}
      ]
    },
    "consensus": {
      "exists": false,
      "strength": 0.287,
      "disagreement_magnitude": 0.422
    }
  },

  "interpretation": {
    "summary": "Regulatory agencies show substantial disagreement...",
    "confidence_note": "High-quality evidence exists across sources..."
  },

  "sources": [...]
}

The Risk Coordinate System

Every source position exists in 5-dimensional risk space:

When agencies disagree, ALETHEIA doesn't pick sides. It shows you the full distribution.

Live demo · prototype

Three compounds, two contexts. Same five lenses, same coordinate system — the shape changes with the (compound, context) pair. Click any cell to open the live Looking Glass.

Theobromine pentagon at the human-adult context — mild caffeine-class stimulant.
Theobromine
Human · adult
 Glyphosate pentagon at the human-adult context — Magnitude wedge dashed red, IARC vs EPA disagreement preserved.
Glyphosate
Human · adult
 Lead pentagon at the human-adult context — severe across all stages, universal regulator agreement.
Lead
Human · adult
 Theobromine pentagon at the dog context — severe Magnitude, chocolate × dog is a textbook acute pet toxicity.
Theobromine
Dog
 Glyphosate pentagon at the dog context — Magnitude contested at compound and material, consensus reached at the product stage.
Glyphosate
Dog
 Lead pentagon at the dog context — similar shape to the adult-human view, universal agreement.
Lead
Dog

Read across the rows: Theobromine transforms (mild → severe), Glyphosate stays contested in both contexts (dashed Magnitude), Lead reads severe regardless. Same coordinate system, different epistemological situation, different shape.

Data source: safety.holisticquality.io — the HQ Safety Database powering this engine and 7 GeodesicNexus consumer safety apps.