API Reference›Servicing Plane›Verification›Create a verification session

Create a verification session

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions Bearer token · CREATE_VERIFICATION

Creates a purpose-bound verification session and returns allowed challenges without exposing answers.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "customerId": "cus_72P0MAYA",
  "caseId": "case_HBR_COL_51",
  "purpose": "account_access",
  "channel": "voice"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "customerId": "cus_72P0MAYA",
  "caseId": "case_HBR_COL_51",
  "purpose": "account_access",
  "channel": "voice"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "customerId": "cus_72P0MAYA",
  "caseId": "case_HBR_COL_51",
  "purpose": "account_access",
  "channel": "voice"
},
)

{
  "verificationSessionId": "ver_MAYA_81",
  "customerId": "cus_72P0MAYA",
  "purpose": "account_access",
  "status": "challenge_required",
  "expiresAt": "2027-05-01T10: 30: 00-07: 00",
  "attemptsRemaining": 2
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

Path & query parameters

Field	Type	Description
Idempotency-Key required in header	string	Stable key for this one logical mutation. Reuse it for retries; reusing it with a different request returns 409.

Body parameters

Field	Type	Description
customerId required	string	Stable opaque customer identifier.
caseId required	string	Stable opaque servicing case identifier.
purpose required	string
channel required	string

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "customerId": "cus_72P0MAYA",
  "caseId": "case_HBR_COL_51",
  "purpose": "account_access",
  "channel": "voice"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "customerId": "cus_72P0MAYA",
  "caseId": "case_HBR_COL_51",
  "purpose": "account_access",
  "channel": "voice"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/verification-sessions",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "customerId": "cus_72P0MAYA",
  "caseId": "case_HBR_COL_51",
  "purpose": "account_access",
  "channel": "voice"
},
)

{
  "verificationSessionId": "ver_MAYA_81",
  "customerId": "cus_72P0MAYA",
  "purpose": "account_access",
  "status": "challenge_required",
  "expiresAt": "2027-05-01T10: 30: 00-07: 00",
  "attemptsRemaining": 2
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}