Location Monitoring
Consent-based background location tracking, drift detection, geofences, webhook alerts, and passive navigation-arrival telemetry for loan portfolios.
Grant background location consent
Registers a customer's one-time legal consent for passive background location monitoring.
Batch consent registration (max 1,000)
Registers consent for multiple customers at once. Supports partial success —
Revoke background location consent
Deactivates consent for a customer + loan pair. Required for regulatory compliance — customers can revoke at any time.
Delete a customer's collected location data (right to erasure)
Immediately erases a customer's collected location pings and drift events — distinct from `/v2/consent/revoke`, which only stops future collection. The scheduled retention job deletes the same rows eventually; this endpoint is for a customer invoking their right to erasure now, without waiting out the retention window. Requires consent to already be revoked (400 otherwise) — revoke first, then delete, so a live monitoring relationship can never be wiped out from under itself. Deliberately does not touch KYC verifications or certificates: those carry their own retention mandate and are never subject to self-service deletion here.
Check consent status
Check consent status
Background location report
Lightweight endpoint called by the bank's mobile SDK in the background.
Drift events for a loan
Returns recent location drift events where the customer moved from their registered zone.
Portfolio-level drift summary
Returns how many monitored customers have drifted from their registered zones.
Configure drift alert webhook
Sets up a webhook URL that receives real-time drift alerts when monitored
View webhook delivery history
Returns delivery attempts for the authenticated user's webhooks, including status, errors, and retry timestamps.
Manually retry a failed webhook delivery
Resets a failed or dead-letter delivery for immediate retry. Cannot retry already-delivered webhooks.
Set ping frequency for a loan
Configure how often the bank's SDK should ping for a specific loan.
Get ping schedule for a loan
Get ping schedule for a loan
Customer location history timeline
Returns daily-aggregated location history for a customer. Shows one entry
List offline (stale) customers
Returns customers who have stopped pinging within their expected schedule.
Export location pings
Download location ping data as CSV or JSON for risk modeling. Supports multiple loan IDs.
Export drift events
Download drift event data for risk analysis.
Export collection zones
Download registered collection zones for all loans.
Create a geofence
Define a geographic zone — circle, polygon, or isochrone (real drive-time
List active geofences
List active geofences
Check if a point breaches any geofences
Check if a point breaches any geofences
Deactivate a geofence
Deactivate a geofence
Record a navigation arrival (passive telemetry)
Fire-and-forget: logs where a navigator ended up vs the pin they routed