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