Quick Start & Integrations

1. curl (Zero Setup)

No API key needed for basic lookups. Try it right now:

curl https://api.aletheia.holisticquality.io/api/compound/50-00-0

Returns compound data for Formaldehyde — risk level, regulatory classifications from 202 agencies, exposure contexts, and 5-dimensional risk synthesis.

2. Python SDK

from aletheia_safety import AletheiaClient

client = AletheiaClient("your-api-key")
compound = client.compound("50-00-0")
print(compound.risk_level, compound.regulatory.ghs_classification)

• Typed responses with 81 dataclasses
• Async support
• 28-test suite

3. Node.js / TypeScript SDK

import { AletheiaClient } from 'aletheia-safety';

const client = new AletheiaClient('your-api-key');
const compound = await client.compound('50-00-0');
console.log(compound.risk_level, compound.regulatory.ghs_classification);

• Full TypeScript interfaces
• ESM and CommonJS
• 24-test suite

4. Batch Lookups

Screen multiple compounds in a single request:

results = client.batch(["50-00-0", "80-05-7", "1336-36-3"])
for r in results:
    print(r.name, r.risk_level)

Up to 20 / 50 / 100 compounds per call (Developer / Pro / Enterprise).

5. Webhooks — Real-Time Updates

Set up a webhook to get notified when regulatory data changes:

• compound.updated — any data change
• compound.risk_changed — risk level moved
• compound.regulatory_changed — new agency classification

All payloads are HMAC-SHA256 signed so you can verify authenticity.

6. Regulatory Watchlist

Monitor specific compounds for regulatory changes:

client.watchlist_add("50-00-0")  # Watch formaldehyde
changes = client.changelog(days=7)  # What changed this week?

Developer tier: 100 watched compounds. Get changelog updates via the API or webhooks.

7. Interactive Playground

Try the API without writing any code:

• api.aletheia.holisticquality.io/api/playground — interactive try-it page
• api.aletheia.holisticquality.io/api/docs — full Swagger documentation