← Back to Tranzia
Tranzia API
Context-aware route risk scoring for your applications.
Advisory only. Tranzia does not predict or prevent incidents.
Built for Enterprise
Duty of Care
Route safety context for late-shift workers, field staff, and corporate travel policies.
Mobility & Dispatch
Fleet routing, delivery optimization, and shuttle services with safety signals.
Travel Platforms
Add pre-trip safety context to booking flows without becoming a maps company.
Audit & Compliance
Defensible decision receipts with versioning, confidence scores, and data freshness.
API Endpoints
MethodEndpointPurpose
POST/v1/accounts/signupCreate organization
POST/v1/accounts/keysGenerate API Key
POST/v1/scoreRaw risk scoring
POST/v1/decisionGet Decision Receipt (Core)
GET/v1/audit/{id}Retrieve receipt with proof
GET/v1/audit/{id}.pdfDownload PDF Receipt
POST/v1/export/pushPush to S3 (BYOB)
Authentication
Include your API key in the X-API-Key header with every request.
X-API-Key: trz_live_xxxx_xxxxxxxxxxxxxxxxxxxxxxxx
Get your API key from the Dashboard.
Quick Start
1. Score a Route (Raw Data)
# Get risk score and safety vectors (No Receipt)
curl -X POST https://tranzia.com/v1/score \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"routes": [{"city_id": "nyc", "origin": "JFK", "destination": "Times Square"}]}'
2. Get Decision Receipt (Audit Grade)
# Generate a defensible receipt with hashed proof
curl -X POST https://tranzia.com/v1/decision \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"context": {"mode": "walk", "local_time": "2024-12-31T23:30:00"}, "route": {"origin": {"lat": 40.76, "lng": -73.98}, "destination": ...}}'
Compare Routes
# Compare 2-3 route options
curl -X POST https://tranzia.com/v1/compare \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"candidates": [
{"id": "route_a", "city_id": "nyc", "origin": "Penn Station", "destination": "Central Park"},
{"id": "route_b", "city_id": "nyc", "origin": "Grand Central", "destination": "Central Park"}
]
}'
Example Response
{
"audit_id": "abc123-...",
"score": 7.8,
"label": "LOW",
"confidence": "HIGH",
"freshness": "2024-12-29",
"components": [
{"name": "crime", "weight": 0.4, "contribution": 0.12},
{"name": "traffic", "weight": 0.2, "contribution": 0.08}
],
"explanation": "Lower incident density near destination..."
}Ready to integrate?
Start with 100 free API calls per day. No credit card required.