ALETHEIA Safety API

Chemical safety data,
structured for machines.

1,879 compounds. 959 materials. 1,262 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

Compound, product, material, and fragrance lookup is free. No key required. Powers 7 GeodesicNexus safety apps.

1,879 Compounds
959 Materials
1,262 Products
202 Regulatory Agencies
13 Risk Contexts
23,149 Tests Passing

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.

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,879 compounds, 1,262 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

Free endpoints require no API key. Paid endpoints require a Developer ($29/mo) or Pro ($99/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.

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