Home

Use this endpoint to request customer journey data for a single transaction or for multiple transactions during a specified timeframe. The results can be useful for evaluating time spent per page and abandonment rates.

Log in to see full request history
Body Params
public_data
object
required

May not contain personally identifiable information (PII).

private_data
object
required

May contain personally identifiable information (PII).

Headers
string
required
Defaults to <calculated_signature>

Encrypted Request Body

string
required
Defaults to <customer_id>

Your provided customer ID.

Responses

Response body
object
public_data
object
string

Version of the API.

string

The requested endpoint.

private_data
object
boolean

True if the API call was successful; false otherwise.

string

A description of the result output, for example, "success" or an error message.

integer

Number of transactions returned.

transactions
array of objects

Array of customer journey data.

transactions
object
string

ID issued at the beginning of a transaction to associate all subsequent processes within the transaction until ended.

string

Your provided customer ID.

string

Customer name associated with the provided customer_id.

date-time

Transaction timestamp.

string

Identification type. Values: na_dl, passport, other.

boolean

True if the customer opened the text message; false otherwise.

string

API version used for the transaction.

boolean

True if the customer finished the transaction; false otherwise.

string

Transaction type.

capture direct desktop portal

string

Transaction URL. This is the URL a customer selects to begin the transaction.

steps_to_run
array of strings

A list of the steps required to complete the transaction.

steps_to_run
boolean

True if the transaction included a fraud-check request to IPQS; false otherwise.

date-time

Date and time at which the fraud-check request was submitted to IPQS.

integer

Count of the landing page visits. This count includes browser refreshes.

boolean

True if the customer browser visited the landing page; false otherwise. The landing page is where the customer must begin the capture process.

date-time

Date and time at which the customer visited the landing page.

date-time

Date and time at which the customer selected the continue button on the landing page.

number

Elapse time in seconds between the landing page visit and exit.

boolean

True if the camera permissions dialog was presented; false otherwise. The camera permissions dialog is where the customer must accept a request to grant permission for camera access.

date-time

Date and time at which the camera permissions dialog was presented.

integer

Count of the camera permissions dialog visits. This count includes browser refreshes.

boolean

True if the customer accepted the request; false otherwise.

date-time

Date and time at which the customer accepted the request.

integer

Count of the camera permissions accepted button selection. Typically one (1).

number

Elapse time in seconds between the camera permissions dialog visit and exit.

boolean

True if the customer browser visited the capture-front page; false otherwise. The front page is where the customer captures an image of the front of the identification document.

integer

Count of the front page visits. This count includes browser refreshes.

boolean

True if the customer approved the captured front-image of the identification document; false otherwise.

number

Elapse time in seconds between the front page visit and exit.

date-time

Date and time at which captured front image was submitted.

date-time

Date and time at which the front page was visited.

boolean

True if the customer browser visited the capture-barcode page; false otherwise. The barcode page is where the customer captures an image of the barcode, which is typically located on the back of the identification document.

number

Elapse time in seconds between the barcode page visit and exit.

date-time

Date and time at which the captured barcode was submitted.

integer

Count of the barcode page visits. This count includes browser refreshes.

date-time

Date and time at which the barcode page was visited.

boolean

True if the customer browser visited the biometrics consent page; false otherwise. The biometric consent page is where a customer must accept the biometric consent policy.

date-time

Date and time at which the biometric consent page was visited.

integer

Count of the biometric consent page visits. This count includes browser refreshes.

boolean

True if the customer browser visited the capture-selfie page; false otherwise. The selfie page is where the customer must capture a selfie portrait.

number

Elapse time in seconds between the selfie page visit and exit.

date-time

Date and time at which the selfie page was visited.

integer

Count of the selfie page visits. This count includes browser refreshes.

boolean

True if the selfie camera permissions page was presented; false otherwise. The selfie camera permissions page is where a customer must accept a request to grant permission for selfie-camera access.

date-time

Date and time at which the selfie camera permissions page was presented.

integer

Count of the selfie camera permissions page visits. This count includes browser refreshes.

boolean

True if the customer accepted the request; false otherwise.

date-time

Date and time at which the selfie camera permissions page was accepted.

integer

Count of the camera permissions accepted button selection. Typically one (1).

number

Elapse time in seconds between the selfie camera permissions page visit and exit.

boolean

True if the transaction successfully concluded; false otherwise.

string

Last-step status message of the capture journey completed by the customer, for example, transaction_completed.

boolean

True if the page-flow journey was completed in a single pass with no revisits or refreshes; false otherwise.

Language