ALETHEIA Safety Intelligence
**ALETHEIA** aggregates chemical and product safety data from public regulatory and scientific sources into a single developer-friendly API — **1,879 compounds**, **959 materials**, and **1,262 consumer products**, with classifications from **15+ global agencies** (IARC, EPA, EU CLP, ECHA, NTP, CalEPA, FDA, OEHHA, and more). Each compound is returned across **19 exposure contexts** — 8 human…
ALETHEIA Safety Intelligence endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
searchFragrance /api/fragrance/search |
|
| GET |
listCompounds /api/compounds |
**Requires Developer+ API key.** Returns a paginated list of compounds with optional search and filters. |
| GET |
getCompoundByCas /api/compound/cas/{cas} |
Reverse CAS lookup. Returns compound metadata inline, or optionally redirects to the canonical compound endpoint. |
| GET |
getCompound /api/compound/{id} |
Returns the aggregated safety record for the given compound and context. Regulatory classifications are normalized across agencies, aggregated into multi-field risk signals… |
| GET |
getCompoundAlternatives /api/compound/{id}/alternatives |
Returns safer alternatives with effectiveness ratings. Free tier: basic list (name + effectiveness). Developer+: full data with tradeoffs, cost, regulatory status, and linked… |
| GET |
search /api/search |
Searches compounds, products, and materials simultaneously. Returns relevance-scored results with entity_type field. Results are sorted by relevance score (highest first). |
| GET |
batchCompounds /api/compounds/batch |
Batch-fetch multiple compounds in a single request. Requires Developer tier or higher (`public` tier returns `401`). Per-request caps: Developer up to 20, Pro up to 50,… |
| GET |
getCompoundRaw /api/compound/{id}/raw |
Returns the full compound data file as stored, without the aggregated risk record. Useful for accessing all fields including crossrefs, identity, dose_response, etc. |
| GET |
getByCategory /api/found-in/by-category/{category} |
**Requires Developer+ API key.** Returns compounds found in the given product/exposure category (e.g., Food, Personal Care, Building). |
| GET |
filter /api/filter |
Filter compounds using AND logic across multiple dimensions. At least one filter parameter must be specified. Results are sorted alphabetically by compound name. |
| GET |
listCategories /api/found-in/categories |
**Requires Developer+ API key.** Returns a summary of all product/exposure categories (Food, Building, Personal Care, etc.). |
| GET |
getBadge /api/badge/{id} |
Returns an SVG image badge showing the compound's risk level, similar to shields.io. Embed via `` tag — no iframe, no API key, CDN-cacheable (24h). **Embed example:** ```html ``` |
| GET |
getFoundIn /api/found-in/{id} |
**Requires Developer+ API key.** Returns where a compound is found — product categories, specific examples, and exposure notes. |
| GET |
getFragranceOverview /api/fragrance |
Returns summary info about the fragrance ingredient catalog including total ingredients, class count, and available endpoints. |
| GET |
getRegulatory /api/regulatory/{id} |
**Requires Developer+ API key.** Returns all regulatory classifications with agency breakdown and summary statistics. |
| GET |
getFragranceStats /api/fragrance/stats |
|
| GET |
getRelationshipGraph /api/relationships/{id}/graph |
**Requires Developer+ API key.** BFS traversal from an entity through the relationship graph. Returns nodes and edges up to the specified depth (1-3). Useful for exploring "what… |
| GET |
getByAgency /api/regulatory/by-agency/{agency} |
**Requires Developer+ API key.** Returns compounds that have been classified by the given regulatory agency (e.g., IARC, EPA, EU CLP). |
| GET |
exportEntities /api/export |
**Requires Developer API key or above.** Downloads all compounds, materials, or products matching the given filters as a CSV or JSON file attachment. Counts as 10 requests… |
| GET |
getRoot /api |
|
| GET |
getReleaseNotes /api/release-notes |
Customer-facing release notes for the API surface itself (not the compound data feed). Returns HTML by default; pass `?format=json` for a structured version list or… |
| GET |
getFreshness /api/freshness |
Public snapshot of how current the ALETHEIA dataset is — entity counts, staleness buckets (current/aging/stale/very_stale/never), and the timestamp of the most recent freshness… |
| GET |
getChangelog /api/changelog |
Returns a chronological feed of compound data changes — risk level updates, new regulatory classifications, property enrichments. Developer+ tier only. |
| GET |
getRelationships /api/relationships/{id} |
**Requires Developer+ API key.** Returns all compounds, materials, and products directly connected to the given entity. Supports filtering by related entity type. |
| GET |
getFragranceClass /api/fragrance/class/{name} |
|
| GET |
getProduct /api/product/{id} |
Returns the full product safety profile aggregating public regulatory and scientific sources: compound composition, hazard summary, exposure assessment, regulatory status,… |
| GET |
getHealth /api/health |
|
| GET |
getProductRaw /api/product/{id}/raw |
Returns the unprocessed product JSON file as stored in the database. No response shaping or auth tier gating applied. |
| GET |
listProducts /api/products |
**Requires Developer+ API key.** Returns a paginated list of consumer products. |
| GET |
getMaterial /api/material/{id} |
Returns the full material data including composition (base compounds + additives + contaminants), behavior (leaching, degradation, offgassing, thermal), safety summary, and… |
| GET |
compareCompounds /api/compounds/compare |
**Requires Developer+ API key.** Returns a rich side-by-side comparison of 2-5 compounds including risk profile differentials, regulatory agency agreement/disagreement matrices,… |
| GET |
listContexts /api/contexts |
Returns all valid safety contexts grouped by category (human, animal, exposure route, environmental), with descriptions and aliases. |
| GET |
listAgencies /api/regulatory/agencies |
**Requires Developer+ API key.** Returns a summary of all regulatory agencies in the database, sorted by number of classifications. |
| GET |
getRelationshipStats /api/relationships/stats |
**Requires Developer+ API key.** Returns overall graph statistics: node count, edge count, and connected entity counts by type. |
| GET |
listFragranceClasses /api/fragrance/classes |
|
| GET |
listMaterials /api/materials |
**Requires Developer+ API key.** Returns a paginated list of materials (polymers, composites, alloys, etc.). |
| GET |
search /api/search |
Searches compounds, products, and materials simultaneously. Returns relevance-scored results with entity_type field. Results are sorted by relevance score (highest first). |
| GET |
getCompoundByCas /api/compound/cas/{cas} |
Reverse CAS lookup. Returns compound metadata inline, or optionally redirects to the canonical compound endpoint. |
| GET |
filter /api/filter |
Filter compounds using AND logic across multiple dimensions. At least one filter parameter must be specified. Results are sorted alphabetically by compound name. |
| GET |
getCompound /api/compound/{id} |
Returns the aggregated safety record for the given compound and context. Regulatory classifications are normalized across agencies, aggregated into multi-field risk signals… |
| GET |
listCompounds /api/compounds |
**Requires Developer+ API key.** Returns a paginated list of compounds with optional search and filters. |
| GET |
batchCompounds /api/compounds/batch |
Batch-fetch multiple compounds in a single request. Requires Developer tier or higher (`public` tier returns `401`). Per-request caps: Developer up to 20, Pro up to 50,… |
| GET |
getCompoundAlternatives /api/compound/{id}/alternatives |
Returns safer alternatives with effectiveness ratings. Free tier: basic list (name + effectiveness). Developer+: full data with tradeoffs, cost, regulatory status, and linked… |
| GET |
getRelationshipStats /api/relationships/stats |
**Requires Developer+ API key.** Returns overall graph statistics: node count, edge count, and connected entity counts by type. |
| GET |
compareCompounds /api/compounds/compare |
**Requires Developer+ API key.** Returns a rich side-by-side comparison of 2-5 compounds including risk profile differentials, regulatory agency agreement/disagreement matrices,… |
| GET |
getChangelog /api/changelog |
Returns a chronological feed of compound data changes — risk level updates, new regulatory classifications, property enrichments. Developer+ tier only. |
| GET |
getRelationships /api/relationships/{id} |
**Requires Developer+ API key.** Returns all compounds, materials, and products directly connected to the given entity. Supports filtering by related entity type. |
| GET |
getFragranceClass /api/fragrance/class/{name} |
|
| GET |
getFragranceStats /api/fragrance/stats |
|
| GET |
searchFragrance /api/fragrance/search |