{"info":{"name":"ALETHEIA Safety Reference API","description":"ALETHEIA Safety Reference API — Chemical and product safety reference API aggregating public regulatory and scientific sources. Covers 1,887 compounds, 959 materials, and 1,287 consumer products with tier labels drawn from published classifications. Returns aggregated safety records across **19 exposure contexts** — 8 human life-stages (adult, child, teen, infant, pregnant, nursing, elderly, immunocompromised), domestic dog and cat, 5 exposure routes (dermal, inhalation, ingestion, ocular, occupational), plus environmental, aquatic-life, terrestrial-wildlife, and pollinator contexts — along with regulatory classifications from 15+ primary agencies-of-record (IARC, EPA, EU CLP, ECHA, NTP, CalEPA, FDA, OEHHA, Health Canada, OSHA/NIOSH, WHO, etc.), exposure source mapping, and published dose-response data.","schema":"https://schema.getpostman.com/json/collection/v2.1.0/collection.json","version":"1.7.0"},"auth":{"type":"apikey","apikey":[{"key":"key","value":"X-API-Key","type":"string"},{"key":"value","value":"{{api_key}}","type":"string"},{"key":"in","value":"header","type":"string"}]},"variable":[{"key":"base_url","value":"https://api.aletheia.holisticquality.io","type":"string","description":"API base URL"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string","description":"Your ALETHEIA API key (get one at aletheia.holisticquality.io/pricing)"}],"item":[{"name":"Compounds","description":"Chemical compound safety records aggregated across multiple exposure contexts","item":[{"name":"Get safer alternatives for a compound","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compound/{id}/alternatives","host":["{{base_url}}"],"path":["api","compound","{id}","alternatives"]},"description":"Returns safer alternatives with effectiveness ratings. Free tier: basic list (name + effectiveness). Developer+: full data with tradeoffs, cost, regulatory status, and linked compound IDs."},"response":[]},{"name":"Get aggregated safety record for a compound","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compound/{id}","host":["{{base_url}}"],"path":["api","compound","{id}"],"query":[{"key":"context","value":"human_adult","description":"Safety context for the aggregated record (e.g., `human_adult`, `dog`, `cat`, `human_child`). Defaults to the compound's primary context.","disabled":true},{"key":"all_contexts","value":"","description":"Set to `true` to get aggregated results for all available contexts at once.","disabled":true}]},"description":"Returns the aggregated safety record for the given compound and context. Regulatory classifications are normalized across agencies, aggregated into multi-field risk signals across several dimensions, and returned as a `risk_level` tier label with supporting evidence fields.\n\n**No API key required** — this is a free endpoint.\n\nIf the aggregated record is unavailable (compound lacks normalizable regulatory data), returns raw safety data with `schema: \"legacy\"`."},"response":[]},{"name":"Get raw compound JSON (unaggregated)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compound/{id}/raw","host":["{{base_url}}"],"path":["api","compound","{id}","raw"]},"description":"Returns the full compound data file as stored, without the aggregated risk record. Useful for accessing all fields including crossrefs, identity, dose_response, etc."},"response":[]},{"name":"Look up a compound by CAS number","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compound/cas/{cas}","host":["{{base_url}}"],"path":["api","compound","cas","{cas}"],"query":[{"key":"redirect","value":"","description":"If `true`, returns a 302 redirect to `/api/compound/{id}` instead of inline data.","disabled":true},{"key":"context","value":"","description":"Context passed through on redirect.","disabled":true}]},"description":"Reverse CAS lookup. Returns compound metadata inline, or optionally redirects to the canonical compound endpoint."},"response":[]},{"name":"List and search compounds","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compounds","host":["{{base_url}}"],"path":["api","compounds"],"query":[{"key":"search","value":"glyphosate","description":"Free-text search across compound name, CAS, and synonyms.","disabled":true},{"key":"risk","value":"","description":"Filter by risk level in the given context.","disabled":true},{"key":"context","value":"","description":"Context for risk level filtering. Only used when `risk` is specified.","disabled":true},{"key":"hazard","value":"","description":"Filter by hazard profile (e.g., `herbicide`, `plasticizer`, `flame_retardant`).","disabled":true},{"key":"cas","value":"","description":"Filter by exact CAS number.","disabled":true},{"key":"type_filter","value":"","description":"Filter by compound functional type (e.g., `surfactant`, `preservative`, `plasticizer`, `uv_filter`, `fragrance_ingredient`).","disabled":true},{"key":"category_filter","value":"","description":"Filter by compound category (e.g., `food_additive`, `pesticide`, `dietary_supplement`).","disabled":true}]},"description":"**Requires Developer+ API key.** Returns a paginated list of compounds with optional search and filters."},"response":[]},{"name":"Batch lookup — multiple compounds in one request (tier-dependent cap)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compounds/batch","host":["{{base_url}}"],"path":["api","compounds","batch"],"query":[{"key":"ids","value":"hq-c-org-000001,hq-c-org-000033,hq-c-org-000100","description":"Comma-separated compound IDs or CAS numbers. Per-request cap is tier-dependent: Developer up to 20, Pro up to 50, Enterprise up to 100. Requests above your cap return `400 \"Too many compounds\"`.","disabled":false},{"key":"context","value":"human_adult","description":"Extract `risk_level` for this context on each compound.","disabled":true}]},"description":"Batch-fetch multiple compounds in a single request. Open to all tiers. Per-request caps: Public up to 10, Developer up to 50, Pro up to 100, Enterprise up to 100 (RapidAPI: Basic 10 / Pro 50 / Ultra 100). Accepts both `hq_id` values and CAS numbers; CAS numbers are auto-resolved and reported under `meta.cas_resolved`. The `synthesize=true` option requires a Developer key or higher."},"response":[]},{"name":"Batch lookup (POST) — JSON body, preferred for >30 IDs","request":{"method":"POST","header":[],"url":{"raw":"{{base_url}}/api/compounds/batch","host":["{{base_url}}"],"path":["api","compounds","batch"]},"description":"POST variant of batch lookup. Prefer POST over GET when your ID list is large (>30 IDs) — GET query strings hit URL length limits, while POST bodies are bounded only by the tier cap (Public 10 / Developer 50 / Pro 100 / Enterprise 100; RapidAPI: Basic 10 / Pro 50 / Ultra 100). Same tier gating as GET. Accepts both `hq_id` values and CAS numbers; CAS numbers are auto-resolved."},"response":[]},{"name":"Compare 2-5 compounds side-by-side (single or multi-context)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compounds/compare","host":["{{base_url}}"],"path":["api","compounds","compare"],"query":[{"key":"ids","value":"hq-c-org-000001,hq-c-org-000033","description":"Comma-separated compound IDs (min 2, max 5). Duplicates are automatically removed.","disabled":false},{"key":"context","value":"human_adult","description":"Safety context for risk profile comparison (single-context mode). Default: `human_adult`. Mutually exclusive with `contexts`.","disabled":true},{"key":"contexts","value":"human_adult,human_child,dog","description":"Comma-separated contexts for multi-context comparison (2-5 contexts). Returns a compound × context risk matrix with escalation factors and vulnerability rankings. Mutually exclusive with `context`.","disabled":true}]},"description":"**Requires Developer+ API key.** Returns a rich side-by-side comparison of 2-5 compounds including risk profile differentials, regulatory agency agreement/disagreement matrices, LD50 toxicity ratios, environmental fate deltas, shared exposure sources, and an auto-generated summary of key differences.\n\n**Multi-context mode:** Pass `contexts` (plural, comma-separated, 2-5 contexts) instead of `context` to compare compounds across multiple exposure contexts simultaneously. Returns a compound × context risk matrix with escalation factors, vulnerability rankings, and cross-context insights. Example: `?ids=X,Y&contexts=human_adult,human_child,dog`"},"response":[]},{"name":"Unified full-text search across all entity types","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/search","host":["{{base_url}}"],"path":["api","search"],"query":[{"key":"q","value":"glyphosate","description":"Search query string. Searches across entity names, identifiers, types, categories, and synonyms. Minimum 2 characters.","disabled":false},{"key":"limit","value":"","description":"Maximum number of results to return per page.","disabled":true},{"key":"offset","value":"","description":"Number of results to skip for pagination.","disabled":true},{"key":"type","value":"compound","description":"Filter results by entity type. If omitted, returns all matching types.","disabled":true}]},"description":"Searches compounds, products, and materials simultaneously. Returns relevance-scored results with entity_type field. Results are sorted by relevance score (highest first)."},"response":[]},{"name":"Advanced filtering for compounds","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/filter","host":["{{base_url}}"],"path":["api","filter"],"query":[{"key":"risk","value":"","description":"Filter by risk level in the specified context.","disabled":true},{"key":"context","value":"human_adult","description":"Safety context for risk filtering. Only used when `risk` is specified. Defaults to `human_adult`.","disabled":true},{"key":"type","value":"preservative","description":"Filter by compound functional type (e.g., `preservative`, `herbicide`, `plasticizer`, `surfactant`).","disabled":true},{"key":"category","value":"","description":"Filter by compound category (e.g., `food_additive`, `pesticide`, `cosmetic_ingredient`).","disabled":true},{"key":"hazard","value":"","description":"Filter by hazard profile classification.","disabled":true},{"key":"hazard_keyword","value":"","description":"Search for keywords within the hazard profile (e.g., `carcinogen`, `neurotoxic`).","disabled":true},{"key":"agency","value":"EPA","description":"Filter by regulatory agency that has classified the compound (e.g., `EPA`, `IARC`, `EU`).","disabled":true},{"key":"cas","value":"","description":"Filter by exact CAS number (e.g., `7732-18-5`).","disabled":true},{"key":"cas_prefix","value":"","description":"Filter by CAS number prefix for matching a range (e.g., `1071` matches all CAS numbers starting with 1071-).","disabled":true},{"key":"limit","value":"","description":"Maximum number of results to return per page.","disabled":true},{"key":"offset","value":"","description":"Number of results to skip for pagination.","disabled":true}]},"description":"Filter compounds using AND logic across multiple dimensions. At least one filter parameter must be specified. Results are sorted alphabetically by compound name."},"response":[]}]},{"name":"Materials","description":"Material composition, behavior, and safety data","item":[{"name":"List and search materials","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/materials","host":["{{base_url}}"],"path":["api","materials"],"query":[{"key":"search","value":"","description":"Free-text search across material name.","disabled":true}]},"description":"**Requires Developer+ API key.** Returns a paginated list of materials (polymers, composites, alloys, etc.)."},"response":[]},{"name":"Get a single material","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/material/{id}","host":["{{base_url}}"],"path":["api","material","{id}"]},"description":"Returns the full material data including composition (base compounds + additives + contaminants), behavior (leaching, degradation, offgassing, thermal), safety summary, and alternatives."},"response":[]}]},{"name":"Products","description":"Consumer product safety and composition data","item":[{"name":"List and search products","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/products","host":["{{base_url}}"],"path":["api","products"],"query":[{"key":"search","value":"","description":"Free-text search across product name, category, tags, and common names.","disabled":true},{"key":"risk","value":"","description":"Filter by overall risk level.","disabled":true},{"key":"tier","value":"","description":"Filter by product tier (CHD, BDY, FOD, HOM, OUT, PET, WER, SPE).","disabled":true},{"key":"category_filter","value":"","description":"Filter by primary category (children, personal_care, food_contact, etc.).","disabled":true}]},"description":"**Requires Developer+ API key.** Returns a paginated list of consumer products."},"response":[]},{"name":"Get aggregated product safety profile","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/product/{id}","host":["{{base_url}}"],"path":["api","product","{id}"]},"description":"Returns the full product safety profile aggregating public regulatory and scientific sources: compound composition, hazard summary, exposure assessment, regulatory status, handling guidance, and lifecycle data. The `synthesis` block contains aggregated risk level tiers derived from the product's compound composition. Free tier: full profile except `compound_traces`. Developer+ tier: includes `compound_traces` showing per-compound risk contributions.\n\n**Note on `brand_examples[]`:** when present, the `brand_examples[]` array lists representative branded products of the category. Concerning ingredients listed in `materials.concerning[]` apply to the category, not necessarily to every named brand. The `brand_examples_disclaimer` sibling field surfaces this framing inline in every response."},"response":[]},{"name":"Get raw product JSON","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/product/{id}/raw","host":["{{base_url}}"],"path":["api","product","{id}","raw"]},"description":"Returns the unprocessed product JSON file as stored in the database. No response shaping or auth tier gating applied."},"response":[]}]},{"name":"Regulatory","description":"Regulatory classifications by agency (IARC, EPA, EU CLP, etc.)","item":[{"name":"Get regulatory classifications for a compound","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/regulatory/{id}","host":["{{base_url}}"],"path":["api","regulatory","{id}"]},"description":"**Requires Developer+ API key.** Returns all regulatory classifications with agency breakdown and summary statistics."},"response":[]},{"name":"List all regulatory agencies with classification counts","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/regulatory/agencies","host":["{{base_url}}"],"path":["api","regulatory","agencies"]},"description":"**Requires Developer+ API key.** Returns a summary of all regulatory agencies in the database, sorted by number of classifications."},"response":[]},{"name":"List compounds classified by a specific agency","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/regulatory/by-agency/{agency}","host":["{{base_url}}"],"path":["api","regulatory","by-agency","{agency}"],"query":[{"key":"limit","value":"","description":"Maximum results to return.","disabled":true}]},"description":"**Requires Developer+ API key.** Returns compounds that have been classified by the given regulatory agency (e.g., IARC, EPA, EU CLP)."},"response":[]},{"name":"Regulatory governance state + Regulatory Change Calendar by analyte/matrix/jurisdiction","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/regulatory-status","host":["{{base_url}}"],"path":["api","regulatory-status"],"query":[{"key":"analyte","value":"","description":"Filter by analyte (case-insensitive). See a 200 response for the full current vocabulary as coverage grows.","disabled":true},{"key":"matrix","value":"processed_baby_food_general","description":"Filter by food-matrix category (case-insensitive). See a 200 response for the full controlled vocabulary.","disabled":true},{"key":"jurisdiction","value":"","description":"Filter by jurisdiction (case-insensitive).","disabled":true},{"key":"as_of","value":"2026-07-06","description":"Resolve the temporal `governance` view (`current`/`upcoming`) as of this calendar date. Defaults to today (UTC). A past date returns the value that was then in force; a future date rolls scheduled changes into `current`.","disabled":true},{"key":"view","value":"","description":"Set to `calendar` for the cross-compound Regulatory Change Calendar (all forward-looking changes aggregated + date-sorted). Any other value returns the default per-cell view.","disabled":true},{"key":"before","value":"2027-01-01","description":"Calendar view only: include only dated changes with an effective date on or before this calendar date (date-TBD proposed changes are excluded when set).","disabled":true}]},"description":"**Requires Developer+ API key.** Returns the regulatory governance state for a growing set of regulated substances (heavy metals — inorganic arsenic, lead, cadmium, mercury — plus PFAS/PFOA/PFOS/GenX, bisphenol A, DEHP, NDMA, and a batch of EU food contaminants: mycotoxins (aflatoxins, ochratoxin A, patulin, deoxynivalenol, zearalenone, fumonisins), benzo[a]pyrene, 3-MCPD, inorganic tin, melamine, and nitrate) across food and product matrices in the US, EU, and California (AB-899) — what threshold (if any) governs a cell, what legal force it carries (binding maximum vs. non-binding guidance vs. a disclosure mandate), and where no governing threshold exists at all (`coverage_gap`). Beyond numeric limits, the layer also carries substance-level **carcinogen classification and listing** changes (`change_type` `classification`/`listing`) sourced from reproducible classifiers — the US NTP Report on Carcinogens (`US_NTP`) and the California OEHHA Proposition 65 list (`CA_Prop65`), with IARC groups cited per-monograph. Distinct from `/api/regulatory/{id}`, which serves IARC/EPA hazard classifications per compound, not content limits per jurisdiction.\n\n**Temporal view.** Each cell carries a `governance_timeline` (the in-force value plus any scheduled/pending future values with their effective dates) and a computed `governance` object — `{current, upcoming}` — resolved as of `as_of` (defaults today; pass `?as_of=YYYY-MM-DD` for a historical or forward view). `current` is the single in-force value covering the date; `upcoming` lists proposed/drafted/scheduled changes with their `confidence` surfaced. **Render guard:** a non-`confirmed` (e.g. `proposed`) value is only ever in `upcoming`, never presented as the current limit.\n\n**Regulatory Change Calendar (`?view=calendar`).** Aggregates every forward-looking change across all substances into one date-sorted list — the pending & scheduled regulatory changes across the covered substances (US/EU/California), a growing seed, **not a comprehensive registry**. Each change carries `analyte`, `jurisdiction`, `status` (`proposed`/`draft`/`adopted`), `confidence`, `effective_from`/`compliance_deadline`, `months_until`, `instrument`, and `source_ref`. The response `coverage` object states the honest denominator (cells / substances / jurisdictions). Optional `?jurisdiction=` and `?before=YYYY-MM-DD` narrow the calendar. **`proposed` reads as proposed, never as a scheduled fact; `adopted` (law passed, not yet effective) is distinct from `proposed`.**\n\nAll filters are optional and combine (AND)."},"response":[]}]},{"name":"Exposure","description":"Where compounds are found — product categories and exposure sources","item":[{"name":"Get exposure sources for a compound","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/found-in/{id}","host":["{{base_url}}"],"path":["api","found-in","{id}"]},"description":"**Requires Developer+ API key.** Returns where a compound is found — product categories, specific examples, and exposure notes."},"response":[]},{"name":"List all exposure categories with compound counts","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/found-in/categories","host":["{{base_url}}"],"path":["api","found-in","categories"]},"description":"**Requires Developer+ API key.** Returns a summary of all product/exposure categories (Food, Building, Personal Care, etc.)."},"response":[]},{"name":"List compounds found in a specific category","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/found-in/by-category/{category}","host":["{{base_url}}"],"path":["api","found-in","by-category","{category}"],"query":[{"key":"limit","value":"","description":"Maximum results to return.","disabled":true}]},"description":"**Requires Developer+ API key.** Returns compounds found in the given product/exposure category (e.g., Food, Personal Care, Building)."},"response":[]}]},{"name":"Relationships","description":"Entity relationship graph — compound ↔ material ↔ product connections with multi-hop traversal","item":[{"name":"Get direct relationships for an entity","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/relationships/{id}","host":["{{base_url}}"],"path":["api","relationships","{id}"],"query":[{"key":"rel_type","value":"","description":"Filter relationships by entity type","disabled":true}]},"description":"**Requires Developer+ API key.** Returns all compounds, materials, and products directly connected to the given entity. Supports filtering by related entity type."},"response":[]},{"name":"Multi-hop graph traversal from an entity","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/relationships/{id}/graph","host":["{{base_url}}"],"path":["api","relationships","{id}","graph"],"query":[{"key":"depth","value":"","description":"Traversal depth (1-3, default 1)","disabled":true},{"key":"rel_type","value":"","description":"Only traverse edges to this entity type","disabled":true}]},"description":"**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 products contain compounds found in this material?\""},"response":[]},{"name":"Relationship graph statistics","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/relationships/stats","host":["{{base_url}}"],"path":["api","relationships","stats"]},"description":"**Requires Developer+ API key.** Returns overall graph statistics: node count, edge count, and connected entity counts by type."},"response":[]}]},{"name":"Reference","description":"Safety contexts, API metadata, and health checks","item":[{"name":"API root — service info and endpoint directory","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api","host":["{{base_url}}"],"path":["api"]},"description":""},"response":[]},{"name":"Health check","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/health","host":["{{base_url}}"],"path":["api","health"]},"description":""},"response":[]},{"name":"Data freshness snapshot","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/freshness","host":["{{base_url}}"],"path":["api","freshness"]},"description":"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 check. Refreshed daily at 06:00 UTC by an internal cron. 30-minute edge cache."},"response":[]},{"name":"List all safety contexts","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/contexts","host":["{{base_url}}"],"path":["api","contexts"]},"description":"Returns all valid safety contexts grouped by category (human, animal, exposure route, environmental), with descriptions and aliases."},"response":[]},{"name":"API release notes — security updates, header contract, new endpoints","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/release-notes","host":["{{base_url}}"],"path":["api","release-notes"],"query":[{"key":"format","value":"","description":"Response format","disabled":true}]},"description":"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 `?format=markdown` for the raw source. Public — no key required. For per-compound data changes see `/api/changelog`."},"response":[]}]},{"name":"Keys","description":"API key management — status, recovery, rotation, and usage history","item":[]},{"name":"Badges","description":"Embeddable SVG safety badges for websites and e-commerce","item":[{"name":"Get embeddable SVG safety badge for a compound","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/badge/{id}","host":["{{base_url}}"],"path":["api","badge","{id}"],"query":[{"key":"context","value":"","description":"Safety context for risk level. Defaults to `human_adult`.","disabled":true},{"key":"style","value":"","description":"Badge visual style.","disabled":true},{"key":"label","value":"","description":"Left-side label text.","disabled":true}]},"description":"Returns an SVG image badge showing the compound's risk level, similar to shields.io. Embed via `<img>` tag — no iframe, no API key, CDN-cacheable (24h).\n\n**Embed example:**\n```html\n<a href=\"https://aletheia.holisticquality.io\">\n  <img src=\"https://api.aletheia.holisticquality.io/api/badge/hq-c-org-000001?context=human_adult\"\n       alt=\"ALETHEIA Safety Badge\" />\n</a>\n```"},"response":[]}]},{"name":"Webhooks","description":"Push notifications for compound data changes","item":[]},{"name":"Watchlist","description":"Personal compound monitoring — track compounds and get enriched status updates","item":[{"name":"List watched compounds with enrichment","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/watchlist","host":["{{base_url}}"],"path":["api","watchlist"],"query":[{"key":"limit","value":"","description":"","disabled":true},{"key":"offset","value":"","description":"","disabled":true}]},"description":"Returns your personal watchlist with enriched compound data (risk levels, CAS, hazard profile). Developer+ tier only."},"response":[]},{"name":"Add compounds to watchlist","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"compounds\": [\n    \"hq-c-org-000001\",\n    \"hq-c-org-000033\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{base_url}}/api/watchlist","host":["{{base_url}}"],"path":["api","watchlist"]},"description":""},"response":[]},{"name":"Remove a compound from watchlist","request":{"method":"DELETE","header":[],"url":{"raw":"{{base_url}}/api/watchlist/{compound_id}","host":["{{base_url}}"],"path":["api","watchlist","{compound_id}"]},"description":""},"response":[]},{"name":"Batch check compounds against your watchlist","request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n  \"compounds\": [\n    \"hq-c-org-000001\",\n    \"hq-c-org-000033\",\n    \"hq-c-ino-000005\"\n  ]\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"{{base_url}}/api/watchlist/check","host":["{{base_url}}"],"path":["api","watchlist","check"]},"description":"Checks up to 100 compound IDs against your watchlist and returns which ones are on it."},"response":[]}]},{"name":"Changelog","description":"Regulatory and data change feed — poll for updates to tracked compounds","item":[{"name":"Get regulatory and data change feed","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/changelog","host":["{{base_url}}"],"path":["api","changelog"],"query":[{"key":"since","value":"","description":"ISO date — filter changes after this date","disabled":true},{"key":"compound_id","value":"","description":"Filter to specific compound","disabled":true},{"key":"type","value":"","description":"Filter by change type","disabled":true},{"key":"summary","value":"","description":"OAS-006: Return compact summary (useful for polling with since)","disabled":true},{"key":"limit","value":"","description":"","disabled":true},{"key":"offset","value":"","description":"","disabled":true}]},"description":"Returns a chronological feed of compound data changes — risk level updates, new regulatory classifications, property enrichments. Developer+ tier only."},"response":[]}]},{"name":"Export","description":"Bulk download — export full entity sets as CSV or JSON for offline analysis and data pipelines","item":[{"name":"Bulk export entity set as CSV or JSON","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/export","host":["{{base_url}}"],"path":["api","export"],"query":[{"key":"type","value":"","description":"Entity type to export.","disabled":false},{"key":"format","value":"","description":"Output format. `csv` returns a flat spreadsheet; `json` returns a structured JSON download.","disabled":true},{"key":"detail","value":"","description":"OAS-007: Set to `full` for expanded columns (Pro+ only, compounds). Includes cross-refs, properties, all contexts.","disabled":true},{"key":"search","value":"","description":"Filter by name/keyword (compounds, materials, products).","disabled":true},{"key":"risk","value":"","description":"Filter by risk level in the given context (compounds only).","disabled":true},{"key":"context","value":"","description":"Exposure context for risk filter (compounds only).","disabled":true},{"key":"hazard","value":"","description":"Filter by hazard profile (compounds only, e.g. `endocrine_disruptor`).","disabled":true},{"key":"type_filter","value":"","description":"Filter by compound type (compounds only, e.g. `herbicide`, `fragrance`).","disabled":true},{"key":"category_filter","value":"","description":"Filter by compound category (compounds only).","disabled":true}]},"description":"**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 against your daily quota. Useful for offline analysis, seeding local databases, or building data pipelines.\n\n**Supported types:** `compounds`, `materials`, `products`\n\n**Supported formats:** `csv` (default), `json`\n\nApplies the same filters as the list endpoints (`/api/compounds`, `/api/materials`, `/api/products`)."},"response":[]}]},{"name":"Fragrance","description":"Fragrance compound records — allergens, musks, and aroma chemicals with classification and search","item":[{"name":"Fragrance catalog overview","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/fragrance","host":["{{base_url}}"],"path":["api","fragrance"]},"description":"Returns summary info about the fragrance ingredient catalog including total ingredients, class count, and available endpoints."},"response":[]},{"name":"Fragrance catalog statistics","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/fragrance/stats","host":["{{base_url}}"],"path":["api","fragrance","stats"]},"description":""},"response":[]},{"name":"List fragrance ingredient classes","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/fragrance/classes","host":["{{base_url}}"],"path":["api","fragrance","classes"]},"description":""},"response":[]},{"name":"Get fragrance class details","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/fragrance/class/{name}","host":["{{base_url}}"],"path":["api","fragrance","class","{name}"]},"description":""},"response":[]},{"name":"Search fragrance ingredients","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/fragrance/search","host":["{{base_url}}"],"path":["api","fragrance","search"],"query":[{"key":"q","value":"","description":"Search query (case-insensitive substring match)","disabled":false}]},"description":""},"response":[]}]},{"name":"Privacy","item":[{"name":"Terms of Use","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/terms","host":["{{base_url}}"],"path":["api","terms"],"query":[{"key":"format","value":"","description":"Response format. Defaults to HTML.","disabled":true}]},"description":"Returns the API terms of service. HTML by default, JSON with ?format=json."},"response":[]},{"name":"Disclaimer","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/disclaimer","host":["{{base_url}}"],"path":["api","disclaimer"],"query":[{"key":"format","value":"","description":"Response format. Defaults to HTML.","disabled":true}]},"description":"Returns the ALETHEIA Disclaimer — the canonical \"reference data, not professional advice\" document, incorporated by reference into both Terms of Service and Privacy Policy. HTML by default, JSON with ?format=json. The JSON `envelope_notice` field exactly matches the `_notice` field that every export response carries (T-2 board memo 2026-05-22)."},"response":[]},{"name":"Compliance & Data Processing Agreements (GDPR Art. 28)","request":{"method":"GET","header":[],"url":{"raw":"{{base_url}}/api/compliance","host":["{{base_url}}"],"path":["api","compliance"],"query":[{"key":"format","value":"","description":"Response format. Defaults to HTML.","disabled":true}]},"description":"Returns DPA status, SCCs, and data transfer documentation for all sub-processors. HTML by default, JSON with ?format=json or Accept: application/json."},"response":[]}]}]}