API Reference›Servicing Workspace›Voice›Submit a verification attempt

Submit a verification attempt

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatchId}/verificationImplementedConnector callbackConnector authority ·Dispatch-bound task-scoped worker token

Compares the borrower’s structured answers against the platform’s own records and issues the dispatch-bound session reference money, promises and quotes require; three failures lock verification for the dispatch.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/$DISPATCH_ID/verification \
  -H "X-LendEasy-Voice-Task-Token: $DISPATCH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "eventId": "b93c1f2a-4d18-4a67-9e70-2c5f8a1d6b04",
  "factors": {
    "dateOfBirth": "1984-03-02",
    "last4Ssn": "6789"
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/${dispatchId}/verification`, {
  method: "POST",
  headers: { "X-LendEasy-Voice-Task-Token": dispatchToken, "Content-Type": "application/json" },
  body: JSON.stringify({
  "eventId": "b93c1f2a-4d18-4a67-9e70-2c5f8a1d6b04",
  "factors": {
    "dateOfBirth": "1984-03-02",
    "last4Ssn": "6789"
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatch_id}/verification",
  headers={"X-LendEasy-Voice-Task-Token": dispatch_token},
  json={
  "eventId": "b93c1f2a-4d18-4a67-9e70-2c5f8a1d6b04",
  "factors": {
    "dateOfBirth": "1984-03-02",
    "last4Ssn": "6789"
  }
},
)

{
  "verificationSessionRef": "vs-1c7e5b90-3f42-4a8d-9c11-6b0e2f4a7d55",
  "state": "VERIFIED",
  "attemptsRemaining": 2
}

{
  "error": "The callback body is invalid."
}

{
  "error": "Invalid or missing connector authority."
}

{
  "error": "No visible voice dispatch exists."
}

{}

Path & query parameters

Field	Type	Description
dispatchId required in path	integer	Positive numeric dispatch identifier.

Body parameters

Field	Type	Description
eventId required	string
factors required	object
dateOfBirth	string
last4Ssn	string

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/$DISPATCH_ID/verification \
  -H "X-LendEasy-Voice-Task-Token: $DISPATCH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "eventId": "b93c1f2a-4d18-4a67-9e70-2c5f8a1d6b04",
  "factors": {
    "dateOfBirth": "1984-03-02",
    "last4Ssn": "6789"
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/${dispatchId}/verification`, {
  method: "POST",
  headers: { "X-LendEasy-Voice-Task-Token": dispatchToken, "Content-Type": "application/json" },
  body: JSON.stringify({
  "eventId": "b93c1f2a-4d18-4a67-9e70-2c5f8a1d6b04",
  "factors": {
    "dateOfBirth": "1984-03-02",
    "last4Ssn": "6789"
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/voice-dispatches/{dispatch_id}/verification",
  headers={"X-LendEasy-Voice-Task-Token": dispatch_token},
  json={
  "eventId": "b93c1f2a-4d18-4a67-9e70-2c5f8a1d6b04",
  "factors": {
    "dateOfBirth": "1984-03-02",
    "last4Ssn": "6789"
  }
},
)

{
  "verificationSessionRef": "vs-1c7e5b90-3f42-4a8d-9c11-6b0e2f4a7d55",
  "state": "VERIFIED",
  "attemptsRemaining": 2
}

{
  "error": "The callback body is invalid."
}

{
  "error": "Invalid or missing connector authority."
}

{
  "error": "No visible voice dispatch exists."
}

{}