Skip to main content
POST
/
v3
/
verify
csharp
using Prove.Proveapi;
using Prove.Proveapi.Models.Components;

var sdk = new ProveAPI(auth: "<YOUR_AUTH_HERE>");

V3VerifyRequest req = new V3VerifyRequest() {
    ClientCustomerId = "e0f78bc2-f748-4eda-9d29-d756844507fc",
    ClientHumanId = "aad25769-23bb-458c-80db-50296a82c91b",
    ClientRequestId = "71010d88-d0e7-4a24-9297-d1be6fefde81",
    EmailAddress = "ecoldman1h@storify.com",
    FirstName = "Elena",
    IpAddress = "192.168.1.1",
    LastName = "Coldman",
    PhoneNumber = "2001004053",
    UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:124.0) Gecko/20100101 Firefox/124.0",
    VerificationType = VerificationType.VerifiedUser,
};

var res = await sdk.V3.V3VerifyRequestAsync(req);

// handle response
{
  "additionalIdentities": [
    {
      "firstName": "Elena",
      "lastName": "Coldman",
      "reasons": "[AL-1a] (Poor quality identity)",
      "assuranceLevel": "AL-1"
    },
    {
      "firstName": "Elena",
      "lastName": "Coldman",
      "reasons": "[AL-1a] (Poor quality identity)",
      "assuranceLevel": "AL-1"
    }
  ],
  "provePhoneAlias": "4B2C41FC4VKDEO100F960011D0AD4A8050MEK19P4SF9PD23EFE27CD2C76A6FAA8375E60AC0550604F6G32D9ED60E06262CCC570F3C15F2D16900184E",
  "proveId": "a07b94ce-218c-461f-beda-d92480e40f61",
  "clientRequestId": "71010d88-d0e7-4a24-9297-d1be6fefde81",
  "clientCustomerId": "261ffa66-961a-4f90-8d93-6c85a450633d",
  "evaluation": {
    "authentication": {
      "result": "pass"
    },
    "identification": {
      "result": "pass"
    }
  },
  "phoneNumber": "2001004053",
  "clientHumanId": "261ffa66-961a-4f90-8d93-6c85a450633d",
  "identity": {
    "firstName": "Elena",
    "lastName": "Coldman",
    "reasons": "[AL2a]",
    "assuranceLevel": "AL2"
  },
  "success": "true",
  "correlationId": "713189b8-5555-4b08-83ba-75d08780aebd"
}

Authorizations

​
Authorization
string
header
required

The access token received from the /token endpoint. Refer to the Authentication page for more details.

Body

application/json
​
phoneNumber
string
required

The mobile phone number. US phone numbers can be passed in with or without a leading +1. International phone numbers require a leading +1. Use the appropriate endpoint URL based on the region the number originates from. Acceptable characters are: alphanumeric with symbols '+'.

Example:

"2001004053"

​
verificationType
enum<string>
required

The verification method based on the use case and authorization level. Current allowed values: "verifiedUser", "accountOpening", "bot", "prefill", "prefillForBiz", "identityResolution".

Available options:
bot,
verifiedUser,
accountOpening,
prefill,
prefillForBiz,
identityResolution
Example:

"verifiedUser"

​
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. The format of this ID is defined by the client - Prove recommends using a GUID, but any format can be accepted. Prove does not offer any functionality around the Client Customer ID. Do not include personally identifiable information (PII) in this field.

Example:

"e0f78bc2-f748-4eda-9d29-d756844507fc"

​
clientHumanId
string

An optional client-generated unique ID our Enterprise customer inputs for that consumer across business lines. If the Enterprise customer has been able to identify a consumer across business lines and has a unique identifier for the consumer, they would input this value to Prove. 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.

Example:

"aad25769-23bb-458c-80db-50296a82c91b"

​
clientRequestId
string

A client-generated unique ID for a specific session. This can be used to identify specific requests. 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.

Example:

"71010d88-d0e7-4a24-9297-d1be6fefde81"

​
emailAddress
string

The email address of the customer. Acceptable characters are: alphanumeric with symbols '@.+'.

Example:

"ecoldman1h@storify.com"

​
firstName
string

The first name of the individual.

Example:

"Elena"

​
ipAddress
string

The public IP address of the session of the individual. Acceptable characters

Example:

"192.168.1.1"

​
lastName
string

The last name of the individual.

Example:

"Coldman"

​
userAgent
string

The User agent of the session of the individual.

Example:

"Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:124.0) Gecko/20100101 Firefox/124.0"

Response

Successful request.

​
correlationId
string
required

The unique ID that Prove generates for the flow.

Example:

"713189b8-5555-4b08-83ba-75d08780aebd"

​
phoneNumber
string
required

The input phone number.

Example:

"2001004053"

​
success
string
required

The result of verification. This can be "true" or "false".

Example:

"true"

​
additionalIdentities
object[]

Additional Identities found as part of the verification flow.

​
clientCustomerId
string

The input ClientCustomerID.

Example:

"261ffa66-961a-4f90-8d93-6c85a450633d"

​
clientHumanId
string

The input ClientHumanID.

Example:

"261ffa66-961a-4f90-8d93-6c85a450633d"

​
clientRequestId
string

The input ClientRequestID.

Example:

"71010d88-d0e7-4a24-9297-d1be6fefde81"

​
evaluation
object

The evaluation result for the policy. This will contain keys titled "authentication" and "risk" that encompass the different evaluation categories.

​
identity
object
Example:
{
  "firstName": "Elena",
  "lastName": "Coldman",
  "reasons": "[AL-1a] (Poor quality identity)",
  "assuranceLevel": "AL-1"
}
​
proveId
string

A Prove-generated identifier for the consumer.

Example:

"a07b94ce-218c-461f-beda-d92480e40f61"

​
provePhoneAlias
string

A persistent ID that uniquely identifies a telephone subscriber.

Example:

"4B2C41FC4VKDEO100F960011D0AD4A8050MEK19P4SF9PD23EFE27CD2C76A6FAA8375E60AC0550604F6G32D9ED60E06262CCC570F3C15F2D16900184E"