Quick Start & Integrations

1. Postman Workspace (No Install)

Explore every endpoint in your browser before installing anything. Three curated collections (Start Here / Use Cases / API Reference) are published on the Postman API Network with the runnable first call wired up — no key required.

Open ALETHEIA on Postman →

• Start Here — five-step onboarding to a real 200 OK in three clicks (caffeine by CAS number)
• Use Cases — problem-shaped requests: regulatory consensus, 5D disagreement detection, material comparison, product safety profile
• API Reference — exhaustive resource-oriented reference for every public endpoint

Fork the workspace into your own Postman, paste your API key into the {{api_key}} global, and every request inherits auth automatically. RapidAPI subscribers can use the alternate-auth path documented in Start Here.

2. 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 major agencies worldwide, exposure contexts, and 5-dimensional risk synthesis.

3. 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

4. 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

5. 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).

6. 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.

7. 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.

8. 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