OkHi Documentation
Ask or search…
Comment on page


Some frequently asked questions about OkHi

End-User Experience

How secure is my data?
We strive to comply with the highest global standards of data privacy, security and compliance. We are NDPR compliant and are working towards becoming fully GDPR and SOC2 compliant. We do not sell or transmit any form of user data that is not collected with their permissions via a cusotmer to anyone other than that customer. Users can manage permissions and opt-out of any data collection at any time by logging into their address book on okhi.me (note that we retain historical records in compliance with regional legal requirements.) By using our services directly or through one of our partners, a user is opting into our Privacy Policy and Terms of Service.
What is the difference between Building name/number and Apartment number?
Building name/number is the name of the building or number that is visible on the road. An apartment number is the number on the door of an apartment unit.
What happens after a user has been verified and turns off location permissions?
Nothing. The user has been verified so no need to get their current location data. (Although we do continue to record if they are at the location where possible for continuous verification.)
Why is my office address not getting verified?
You have to select the "work" option instead of "home" during the creation of the address. You can view this on OkHi.me as well.
Does OkHi work with a VPN?
Our library does not support the use of VPN as that would allow users to fraudulently verify addresses that they are not at. You need to turn a VPN off to be verified with OkHi.

Technical Systems & Terms

Why are many of the verifications "unknown"?
We classify an address as "unknown" when there is not enough data is being transmitted to our servers for verification. There are a few ways to mitigate unknowns here.
What is the accuracy of the verification?
The accuracy of the GPS on the device can differ greatly depending on reception and device type. We only collect data points within a few hundred meters of where they drop the pin for the address and analyse these over time. As we aggregate many of these points the accuracy of any single data point does not massively influence the verification.
Another type of accuracy is the confidence that we have in reducing false positives in the verification process. While we are constantly improving the ML models, our standards are comfortably higher than any other type of address verification.
What is re-verification?
A re-verification is when we run verification on an address that has been previously verified. This process is done to make sure a user still stays at the address they were previously or to try again after correcting for circumstances that may have resulting in a Not at address or Unknown status.
How long does verification take?
It depends widely on how much data our systems receive and we aim to verify as fast as possible - without comprimising on accuracy. For the first time an address is being verified, it takes at least 36hours for us to be sure and we will continue trying to verify the address for up to 8 days. (80% of successful verifications come in within 48 hours.)

Common Developer Questions

How long does it take the mode to change from 'first-time' to 'continuous' after an address is verified?
The update will take 5 to 10 minutes to be sent via the API webhook after verification is completed.
Is the email field required for a user?
Technically the email field is not required, but we advise that you do send it through whenever you can for easy user management and notifications. Note that there may be additional notification charges if we do not have email addresses for users.
Where do I get my login for the dashboard?
You can monitor the status of your customers verifications by loging into the dashboard. We will send you the initial login details along with your API information after completing this form. If you're having further trouble, get in touch with our team directly.
Why is an address not appearing on the dashboard?
Only addresses that have started verification show up on the dashboard. (So they won't show if they an address is only created without verification starting.) You can always see a full history of addresses that were previously verified on the customer dashboard.

Questions from Testing and QA

What is the maximum address per device?
A device can not verify more than 20 locations at a time. To create more, you need to uninstall and reinstall the app to clear all data (and geofences.) This will stop new data being sent for the previous geofences.
Have further questions? Reach out to our team directly.