Quickstart

Use the sandbox to authenticate, send a capture event, and confirm that the state engine resolves it.

1. Create an API key

curl -X POST https://api.barcloudapp.com/v1/keys \
  -H "Authorization: Bearer <token>"

2. Send your first event

curl -X POST https://api.barcloudapp.com/v1/events \
  -H "Authorization: Bearer op_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "badge.read",
    "entity_id": "worker-091",
    "facility_id": "chi-2",
    "captured_at": "2026-04-24T14:03:12.441Z"
  }'

3. Query live state

curl https://api.barcloudapp.com/v1/entities/worker-091 \
  -H "Authorization: Bearer op_live_xxx"