Fetch Device Information and Geolocation Data

What is device information and geolocation data?

Device information is all data that helps identify the device used for an onboarding session, such as the user cellphone. This data is not secretly collected. Your application should directly report this to Incode with the related SDK methods. Geolocation data is a subset of device information. Expressed as latitude/longitude, geolocation data represents the physical location in the world where the onboarding took place.

How can I access device information?

You can view device information for an onboarding session by going to Dashboard > Sessions. Locate and select the session you want to view, then click the Other tab and scroll down to the Device and Location sections.

You can use the fetch device info API endpoint to obtain the information as a JSON response. You can also test the endpoint yourself at preceding link to our API documentation. This is the same API endpoint used by the Incode Dashboard.

When you fetch device information for a given onboarding session yourself, you should always pass the session's unique interview ID, also called the Session ID, to the fetch device info API endpoint. If you do not pass the interview ID, we will attempt to extract the interview ID from the session token.

What device information is available?

While device information can vary, you can typically get the following commonly used device information:

• IP address of the device
• IP geolocation of the device (the latitude and longitude of the device IP may differ from the geolocation data of the device itself)
• Device geolocation data
• Hash (unique device identifier)
• Device (for example, the brand or type of cellphone)
• OS Version
• Device model
• Browser (for websdk-created sessions)
• SDK Version