Prove Identity Manager Overview

Learn about the components that make up the Prove Identity Manager solution

Prove Identity Manager solution

The Prove Identity Manager solution provides phone risk change events based on the connection between an enrolled consumer ID and their phone number via webhook. Updates can include, but aren’t limited to, the following attributes:

• Phone Number Disconnects
• Phone Number Changes
• Line Type Changes
• Carrier Changes

Pain points

• Inconsistent and Manual Monitoring: Lack of continuous monitoring causes customer friction in validating contact numbers, increases call center costs, and hinders customer outreach.
• Verifying Customer Identity Linkages: Difficulty in authenticating customer identities and their data connections risks fraud and hinders personalized experiences.
• Managing Dynamic Customer Attributes: Manual updates of customer attributes are time-consuming and error-prone.

Value drivers

1. Enhanced Identity Certainty and Security: It provides a more robust and reliable way to confirm the true identity of individuals interacting with a business. This increased certainty minimizes the risk of fraud, unauthorized access, and account takeovers.
2. Reduced Friction in Customer Interactions: Customers can quickly and easily verify their identity without lengthy forms or complicated procedures. This not only improves customer satisfaction but also reduces the time it takes to complete transactions and access services. The result is a more efficient and positive customer experience from the initial interaction onward.
3. Improved Operational Efficiency: Manual processes are time-consuming, resource-intensive, and prone to error. This solution automates key steps, freeing up valuable staff time and reducing operational costs.
4. Increased Trust and Safety in Customer Relationships: Establishing and maintaining trust is paramount in today’s business environment. This solution plays a crucial role in fostering trust and ensuring the safety of customer relationships. By providing a secure and reliable way to verify identities, it demonstrates a commitment to protecting customer information and preventing fraud. Customers feel more confident and secure knowing that their interactions are protected by robust security measures. This enhanced level of trust translates into stronger customer relationships, increased loyalty, and positive word-of-mouth. Moreover, by proactively mitigating risks and preventing fraudulent activities, this solution helps create a safer environment for both the business and its customers.

Enroll Identity

The Enroll Identity call enrolls a single customer for monitoring using their phone number and unique identifier.

Field	Field Type	Enroll Identity	Description
phoneNumber	string	Required	The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string	Required	The verified first name of the user.
lastName	string	Required	The verified last name of the user.
emailAddress	string	Optional	The email address associated with the phone number.
email (date last verified)	string	Optional	The date the email address was last verified (e.g., 2023-01-01 ).
address	list object	Optional	A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string	Optional	The street address of the individual.
extendedAddress (street2)	string	Optional	The apartment number or other extended address information.
city	string	Optional	The city of the individual.
region	string	Optional	The state or locality of the individual.
postalCode	string	Optional	The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string	Optional	The date of birth associated with the phone number.
nationalId	string	Optional	The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string	Optional	The IP address of the user.
deviceId	string	Optional	A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string	Optional	Your unique request identifier.
clientCustomerId	string	Optional	A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
success	boolean	✅
phoneNumber	string
verifyResult (GFP Result)	string	✅
assuranceLevel	string	✅
correlationId	string	✅
proveId	string	✅
proveKey	string	✅
identityId	string	✅
clientRequestID	string
clientHumanID	string
clientCustomerId	string
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Batch Enroll Identities

The Batch Enroll Identities call allows enrollment of many customers at once for efficient bulk operations.

Field	Field Type	Batch Enroll Identity	Description
phoneNumber	string	Required	The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string	Required	The verified first name of the user.
lastName	string	Required	The verified last name of the user.
emailAddress	string	Optional	The email address associated with the phone number.
email (date last verified)	string	Optional	The date the email address was last verified (e.g., 2023-01-01 ).
address	list object	Optional	A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string	Optional	The street address of the individual.
extendedAddress (street2)	string	Optional	The apartment number or other extended address information.
city	string	Optional	The city of the individual.
region	string	Optional	The state or locality of the individual.
postalCode	string	Optional	The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string	Optional	The date of birth associated with the phone number.
nationalId	string	Optional	The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string	Optional	The IP address of the user.
deviceId	string	Optional	A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string	Optional	Your unique request identifier.
clientCustomerId	string	Optional	A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
error	string	✅
phoneNumber	string
verifyResult (GFP Result)	string	✅
assuranceLevel	string	✅
correlationId	string	✅
proveId	string	✅
proveKey	string	✅
identityId	string	✅
clientRequestID	string
clientHumanID	string
clientCustomerId	string
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Get Identities

The Get Identity calls offer various ways to retrieve identity information:

• Return a list of all identities you have enrolled in Identity Manager.
• Get specific identity by ID.
• Lookup identities by phone number.

Field	Field Type	Get Identity	Description
phoneNumber	string	Optional	The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string		The verified first name of the user.
lastName	string		The verified last name of the user.
emailAddress	string		The email address associated with the phone number.
email (date last verified)	string		The date the email address was last verified (e.g., 2023-01-01 ).
address	list object		A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string		The street address of the individual.
extendedAddress (street2)	string		The apartment number or other extended address information.
city	string		The city of the individual.
region	string		The state or locality of the individual.
postalCode	string		The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string		The date of birth associated with the phone number.
nationalId	string		The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string		The IP address of the user.
deviceId	string		A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
identityId	string	Required	A unique Prove-generated identifier for the enrolled identity.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string	Optional	Your unique request identifier.
clientCustomerId	string		A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
success	boolean
phoneNumber	string	✅
verifyResult (GFP Result)	string	✅
assuranceLevel	string	✅
correlationId	string	✅
proveId	string	✅
proveKey	string	✅
identityId	string	✅
deviceId	string	✅
active	boolean	✅
carrier	string	✅
lineType	string	✅
countryCode	string	✅
createdAt	integer	✅
creationString	string	✅
clientRequestID	string
clientHumanID	string
clientCustomerId	string	✅
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Get Identities By Phone Number

Field	Field Type	Get Identity	Description
phoneNumber	string	Required	The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string		The verified first name of the user.
lastName	string		The verified last name of the user.
emailAddress	string		The email address associated with the phone number.
email (date last verified)	string		The date the email address was last verified (e.g., 2023-01-01 ).
address	list object		A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string		The street address of the individual.
extendedAddress (street2)	string		The apartment number or other extended address information.
city	string		The city of the individual.
region	string		The state or locality of the individual.
postalCode	string		The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string		The date of birth associated with the phone number.
nationalId	string		The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string		The IP address of the user.
deviceId	string		A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
identityId	string		A unique Prove-generated identifier for the enrolled identity.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string	Optional	Your unique request identifier.
clientCustomerId	string		A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
success	boolean
phoneNumber	string	✅
verifyResult (GFP Result)	string	✅
assuranceLevel	string	✅
correlationId	string	✅
proveId	string	✅
proveKey	string	✅
identityId	string	✅
deviceId	string	✅
active	boolean	✅
carrier	string	✅
lineType	string	✅
countryCode	string	✅
createdAt	integer	✅
creationString	string	✅
clientRequestID	string
clientHumanID	string
clientCustomerId	string	✅
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Activate Identity

The Activate/Deactivate Identity calls control monitoring status:

• Activate sets an identity as active for monitoring.
• Deactivate stops webhook notifications without disenrolling the identity.

Field	Field Type	Get Identity	Description
phoneNumber	string		The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string		The verified first name of the user.
lastName	string		The verified last name of the user.
emailAddress	string		The email address associated with the phone number.
email (date last verified)	string		The date the email address was last verified (e.g., 2023-01-01 ).
address	list object		A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string		The street address of the individual.
extendedAddress (street2)	string		The apartment number or other extended address information.
city	string		The city of the individual.
region	string		The state or locality of the individual.
postalCode	string		The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string		The date of birth associated with the phone number.
nationalId	string		The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string		The IP address of the user.
deviceId	string		A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
identityId	string	Required	A unique Prove-generated identifier for the enrolled identity.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string	Optional	Your unique request identifier.
clientCustomerId	string		A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
success	boolean	✅
phoneNumber	string
verifyResult (GFP Result)	string
assuranceLevel	string
correlationId	string
proveId	string
proveKey	string
identityId	string
deviceId	string
active	boolean
carrier	string
lineType	string
countryCode	string
createdAt	integer
creationString	string
clientRequestID	string
clientHumanID	string
clientCustomerId	string
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Deactivate Identity

Field	Field Type	Get Identity	Description
phoneNumber	string		The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string		The verified first name of the user.
lastName	string		The verified last name of the user.
emailAddress	string		The email address associated with the phone number.
email (date last verified)	string		The date the email address was last verified (e.g., 2023-01-01 ).
address	list object		A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string		The street address of the individual.
extendedAddress (street2)	string		The apartment number or other extended address information.
city	string		The city of the individual.
region	string		The state or locality of the individual.
postalCode	string		The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string		The date of birth associated with the phone number.
nationalId	string		The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string		The IP address of the user.
deviceId	string		A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
identityId	string	Required	A unique Prove-generated identifier for the enrolled identity.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string	Optional	Your unique request identifier.
clientCustomerId	string		A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
success	boolean	✅
phoneNumber	string
verifyResult (GFP Result)	string
assuranceLevel	string
correlationId	string
proveId	string
proveKey	string
identityId	string
deviceId	string
active	boolean
carrier	string
lineType	string
countryCode	string
createdAt	integer
creationString	string
clientRequestID	string
clientHumanID	string
clientCustomerId	string
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Disenroll Identity

Field	Field Type	Get Identity	Description
phoneNumber	string		The number of the mobile phone. Acceptable characters are: alphanumeric with symbols ’+’.
phoneNumber (date last verified)	string		The last date that a possession check was completed for a phone number. The format is YYYY-MM-DD. Acceptable characters are: numeric with symbol ’-‘
verificationType	string		Prove offers different verification methods based on your use case and authorization level required. Available verification methods are: bot verifiedUsers prefill prefillForBusiness accountOpening identityResolution
firstName	string		The verified first name of the user.
lastName	string		The verified last name of the user.
emailAddress	string		The email address associated with the phone number.
email (date last verified)	string		The date the email address was last verified (e.g., 2023-01-01 ).
address	list object		A list of up to three verified addresses for the user, each containing street , street2 , city , region , and postalCode .
street	string		The street address of the individual.
extendedAddress (street2)	string		The apartment number or other extended address information.
city	string		The city of the individual.
region	string		The state or locality of the individual.
postalCode	string		The zip code of the individual. It can be either 5 digits (XXXXX) or ZIP+4 (XXXXX-XXXX).
dateOfbirth	string		The date of birth associated with the phone number.
nationalId	string		The user’s national ID, such as the full or last four digits of their SSN.
ipAddress	string		The IP address of the user.
deviceId	string		A string that is the unique identifier for the Prove Key on the device. Only applicable if you are leveraging Prove Unified Authentication.
identityId	string		A unique Prove-generated identifier for the enrolled identity.
correlationId	string		A unique ID that links all calls for the same flow. This is a crucial field to save for subsequent calls.
clientRequestId	string		Your unique request identifier.
clientCustomerId	string		A client-generated unique ID for a specific customer. This can be used by clients to link calls related to the same customer, across different requests or sessions.
clientHumanID	string		A client-generated unique ID for a specific customer that has been identity proofed. This can be used by clients to link calls related to the same customer, across different requests or sessions. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Do not include personally identifiable information (PII) in this field.

Field	Field Type	Enroll Identity
success	boolean
phoneNumber	string
verifyResult (GFP Result)	string
assuranceLevel	string
correlationId	string
proveId	string
proveKey	string
identityId	string	✅
deviceId	string
active	boolean
carrier	string
lineType	string
countryCode	string
createdAt	integer
creationString	string
clientRequestID	string	✅
clientHumanID	string
clientCustomerId	string
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string

Webhook

Field	Field Type	Enroll Identity
success	boolean
phoneNumber	string
verifyResult (GFP Result)	string
assuranceLevel	string
correlationId	string
proveId	string
proveKey	string
identityId	string	✅
deviceId	string
active	boolean
carrier	string
lineType	string
countryCode	string
createdAt	integer
creationString	string
clientRequestID	string
eventId	string	✅
event	string	✅
eventType	string	✅
eventTimestamp	string	✅
clientHumanID	string
clientCustomerId	string	✅
identity	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email(s)	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string
reasons	list of objects
additionalIdentities	list of objects
firstName	string
lastName	string
nationalId	string
dateOfBirth	string
email	list of objects
email1	string
email2	string
address(es)	list of objects
streetAddress	string
streetAddress2	string
city	string
region	string
zipCode	string