Event Catalog
VECU platform services emit events when significant state changes occur -- a vehicle custody is transferred, a credential is issued, an identity verification completes. External integrators receive these events via webhooks, enabling real-time reactions without polling.
How It Works
Events flow through Amazon EventBridge: each service publishes to its own bus, and the Event Relay Service subscribes to those buses and forwards matching events to your registered webhook endpoints.
All events follow a standard envelope format based on the CloudEvents specification.
Product Groups
Events are organized into product groups for easy webhook subscription configuration:
| Product Group | Event Namespaces | Status | Use When |
|---|---|---|---|
CUSTODY_SDK | custody.*, authorization.*, credential.* | All Active | Building vehicle custody, transfer, or credential workflows |
IDV_SDK | idv.* | All Coming Soon | Building identity verification or reverification flows |
Subscribe by product group in your webhook configuration:
{
"eventFilters": {
"productGroups": ["CUSTODY_SDK"]
}
}
Or subscribe to individual event types or patterns:
{
"eventFilters": {
"include": ["custody.vehicle.released", "credential.identity.revoked"]
}
}
wallet.* and authorizationpool.* are not currently assigned to a named
product group in the relay. To receive these events, subscribe using
individual event type names (e.g., wallet.credential.stored) or a wildcard
pattern (e.g., wallet.*, authorizationpool.*) in the include filter.
Event Statuses
Active Currently relayed to webhook subscribers.
Coming Soon Implemented in the source service -- relay subscription planned.
Browse Events
Custody SDK Events
custody.*, authorization.*, credential.* (via CUSTODY_SDK product group), plus authorizationpool.* and wallet.* (individual filter required)
IDV SDK Events
idv.*