ALETHEIA Examples

Glyphosate at the dog context. Notice the lower standard deviation and higher consensus strength than the contested human-adult call.

GET /api/compound/hq-c-org-000001?context=dog

from aletheia_safety import Aletheia

client = Aletheia()
result = client.compound("hq-c-org-000001", context="dog")

import { Aletheia } from "aletheia-safety";

const client = new Aletheia();
const result = await client.compound("hq-c-org-000001", { context: "dog" });

Glyphosate carcinogenicity, human-adult context. IARC classifies it Group 2A (probably carcinogenic), EPA’s Office of Pesticide Programs classifies it “not likely to be carcinogenic to humans” (2020), and EFSA finds it “unlikely to pose a carcinogenic hazard to humans” (2015). EPA’s IRIS programme is a separate assessment: Group D, not classifiable (1989). The aggregated record surfaces the disagreement directly — see consensus.exists: false and the wide source_positions spread.

GET /api/compound/hq-c-org-000001?context=human_adult

from aletheia_safety import Aletheia

client = Aletheia()
result = client.compound("hq-c-org-000001", context="human_adult")
# result["consensus"]["exists"] == False
# result["consensus"]["disagreement_magnitude"] ~ 0.42

import { Aletheia } from "aletheia-safety";

const client = new Aletheia();
const result = await client.compound("hq-c-org-000001", { context: "human_adult" });
// result.consensus.exists === false
// result.consensus.disagreement_magnitude ~ 0.42

Same compound, every available context in a single response. Use this when you need to compare risk profiles across populations or exposure routes without firing N separate calls.

GET /api/compound/hq-c-org-000001?all_contexts=true

from aletheia_safety import Aletheia

client = Aletheia()
result = client.compound("hq-c-org-000001", all_contexts=True)
# result["contexts"] = { "human_adult": {...}, "dog": {...}, ... }

import { Aletheia } from "aletheia-safety";

const client = new Aletheia();
const result = await client.compound("hq-c-org-000001", { allContexts: true });
// result.contexts = { human_adult: {...}, dog: {...}, ... }

Discover what contexts the API supports. Each context comes with a description and a list of aliases the API will accept.

GET /api/contexts

from aletheia_safety import Aletheia

client = Aletheia()
contexts = client.contexts()
# contexts = [{"context": "human_adult", "description": "...", "aliases": [...]}, ...]

import { Aletheia } from "aletheia-safety";

const client = new Aletheia();
const contexts = await client.contexts();
// contexts = [{ context: "human_adult", description: "...", aliases: [...] }, ...]