Skip to main content
Version: v5

Getting the Installation ID

The Incognia SDK collects location and device data to build a behavioral profile for mobile users. This data is tagged with an identifier called Installation ID, which is automatically generated by the SDK.

To use the Incognia APIs, you must forward the Installation ID as a request header or as a property of the request body in every relevant request made to your backend server that will use Incognia's risk assessments (e.g., a login request).

The following example shows how to forward the Installation ID as an HTTP header.

ILMInLoco.getInstallationId({ installationId in  if installationId != nil {    // Setting the installationId as a Header
    // NSURLRequest    request.setValue(      installationId,      forHTTPHeaderField: "Incognia-Installation-ID"    )  }
  // Send the request with the installationId to your backend server})

This header or property should then be read and assigned as the installation_id property in requests made to the Incognia API, allowing you to retrieve a risk score and supporting evidence for events during onboarding, login, and payments.

Getting the Installation ID