API docs
Events, hosted links, decisions, and audit logs.
Prooflane accepts trust-sensitive action events with scoped bearer keys and idempotent customer event ids. Each accepted event returns a hosted verification link, decision state, and an audit trail designed for launch review.
POST /api/v1/events
Creates a verification event, upserts a subject, and returns a hosted verification URL. Duplicate `customer_event_id` values return the original event instead of creating another case.
curl -X POST https://api.prooflane.com/api/v1/events \
-H "Authorization: Bearer pl_live_or_test_key" \
-H "Idempotency-Key: seller-listing-123" \
-H "Content-Type: application/json" \
-d '{
"customer_event_id": "seller_listing_123",
"flow_id": "flow_123",
"subject": {
"external_subject_id": "seller_456",
"type": "human",
"email": "owner@example.com"
},
"trigger": {
"type": "listing_publish",
"source": "marketplace_app",
"risk_context": { "listing_value": 2400 }
}
}'GET /api/v1/events
Lists event status, decision, and hosted link references.
GET /api/v1/events/{id}/decision
Returns decision, reason codes, risk score, and policy trace.
GET /api/v1/audit-logs
Returns append-only audit events for event intake, subject evidence, and decisions.