Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.prove.com/llms.txt

Use this file to discover all available pages before exploring further.

Flowchart: Human Assurance from v3/verify through a Success decision to Success=False or Success=True, then Continuous Monitoring and a phone number change event after success
Identities that pass the Global Fraud Policy are automatically enrolled in Manage.

​
Prerequisites

  • Access token — Obtain a bearer token using Prove OAuth (Authentication).

​
Implementation steps

1

Gather Required Inputs

Collect the phone number from your CRM or database.
2

Call the Verify Endpoint

Make a request to the /v3/verify endpoint including the Authorization header. Use the bearer token as outlined on the Authentication page.
cURL
curl -X POST "https://platform.uat.proveapis.com/v3/verify" \
-H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
-H "Content-Type: application/json" \
-d '{
    "phoneNumber": "2001004051",
    "verificationType": "humanAssurance",
    "clientRequestId": "test-001"
}'
Replace <YOUR_ACCESS_TOKEN> with your acquired access token.
For Human Assurance, set verificationType to humanAssurance and include phoneNumber. You can also pass clientRequestId, clientCustomerId, clientHumanId, or proveId when you need that linkage.
3

Process the Response

Use the samples below together with the /v3/verify response schema. Cross-check field meanings with Assurance levels and Global Fraud Policy when interpreting codes and evaluations.
{
    "success": "true",
    "clientRequestId": "test-001",
    "phoneNumber": "2001004051",
    "identity": {
        "assuranceLevel": "AL1"
    },
    "evaluation": {
        "authentication": {
            "result": "pass"
        },
        "risk": {
            "result": "pass"
        }
    }
}

​
In practice

  • success — Branch your UX and backend logic on pass vs fail.
  • identity — Read assuranceLevel for human-vs-automation policy (allow, challenge, block).
  • evaluation — Interpret authentication and risk outcomes under Global Fraud Policy; use failure codes when success is false. For Human Assurance, weigh both authentication and risk results when you tune thresholds.
  • proveId — Persist proveId when present if you need support, auditing, or linking to other Prove flows.
If you passed optional identifiers on the request, the response may echo clientCustomerId and clientHumanId; see the /v3/verify reference for details.

​
Sandbox testing

​
Test users

You must use project credentials when working with sandbox test users. Attempting to use these test users with different project credentials results in an unauthorized access error.
The following test users are available for testing using the /v3/verify endpoint in the Sandbox environment. Use these test users to simulate different verification scenarios and outcomes.
Use these test phone numbers exactly as shown. The sandbox environment doesn’t validate real customer information.
Phone NumberFirst NameLast NameVerification TypeExpected Outcome
2001004051EwenBrimilcomehumanAssuranceSuccess
2001004052HilaryKumaarhumanAssuranceFailed

​
Testing steps

Use test user Ewen Brimilcome to verify a successful verification:
cURL
curl -X POST "https://platform.uat.proveapis.com/v3/verify" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "verificationType": "humanAssurance",
    "clientRequestId": "test-001",
    "phoneNumber": "2001004051"
  }'
Expected response:
{
    "success": "true",
    "clientRequestId": "test-001",
    "phoneNumber": "2001004051",
    "identity": {
        "assuranceLevel": "AL1"
    },
    "evaluation": {
        "authentication": {
            "result": "pass"
        },
        "risk": {
            "result": "pass"
        }
    }
}

Related topics

Human Assurance ConnectHuman AssuranceVerifyVerified User ConnectVerified User Verify