API Reference › Servicing Workspace › Hardship › Ask the borrower for a replacement document Ask the borrower for a replacement document POST https://sandbox.api.lendeasy.ai /v1/servicing/cases/{caseId} /hardship/evidence/replacement-requests Implemented REQUEST_SERVICING_HARDSHIP_EVIDENCE_REPLACEMENT&ISSUE_SERVICING_DOCUMENT_INVITATION
Closes the open evidence cycle, opens the next one, and issues the borrower a live upload link in the same transaction.
cURL Node Python
Request
curl -X POST https://sandbox.api.lendeasy.ai /v1/servicing/cases/$CASE_ID/hardship/evidence/replacement-requests \
-H "Authorization: Bearer $TOKEN" \
-H "LendEasy-Tenant: $TENANT" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{
"reasonCode": "SANITIZATION_INCOMPLETE",
"note": "Certificate arrived as a photograph of a screen."
}' await fetch(`https://sandbox.api.lendeasy.ai /v1/servicing/cases/${caseId}/hardship/evidence/replacement-requests` , {
method: "POST" ,
headers: { Authorization: `Bearer ${token}` , "LendEasy-Tenant" : tenant, "Idempotency-Key" : idempotencyKey, "Content-Type" : "application/json" },
body: JSON.stringify({
"reasonCode": "SANITIZATION_INCOMPLETE",
"note": "Certificate arrived as a photograph of a screen."
}),
});requests.post(
f"https://sandbox.api.lendeasy.ai /v1/servicing/cases/{case_id}/hardship/evidence/replacement-requests" ,
headers={"Authorization" : f"Bearer {token}" , "LendEasy-Tenant" : tenant, "Idempotency-Key" : idempotency_key},
json={
"reasonCode": "SANITIZATION_INCOMPLETE",
"note": "Certificate arrived as a photograph of a screen."
},
)200 403 404 409
{
"cycleNo": 2 ,
"invitationId": "inv_5N1K",
"deliveryStatus": "QUEUED"
}{
"developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
"httpStatusCode": "403",
"defaultUserMessage": "The request could not be applied.",
"userMessageGlobalisationCode": "error.msg.not.authorized",
"errors": []
}{
"developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
"httpStatusCode": "404",
"defaultUserMessage": "The request could not be applied.",
"userMessageGlobalisationCode": "error.msg.resource.not.found",
"errors": []
}{
"developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
"httpStatusCode": "409",
"defaultUserMessage": "The request could not be applied.",
"userMessageGlobalisationCode": "idempotency.request.in.flight",
"errors": []
}Path & query parameters Field Type Description LendEasy-Tenant required in header string Opaque active LendEasy tenant-registry identifier. Supply exactly one instance; no alternate tenant selector is accepted. caseId required in path integer Positive numeric case identifier. Idempotency-Key optional in header string Optional replay key for this logical mutation. Omission creates a fresh server-owned key for this attempt; blank, repeated, or longer-than-50-character values are rejected.
Body parameters Field Type Description reasonCode required string Configured structured reason code. note required string
cURL Node Python
Request
curl -X POST https://sandbox.api.lendeasy.ai /v1/servicing/cases/$CASE_ID/hardship/evidence/replacement-requests \
-H "Authorization: Bearer $TOKEN" \
-H "LendEasy-Tenant: $TENANT" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{
"reasonCode": "SANITIZATION_INCOMPLETE",
"note": "Certificate arrived as a photograph of a screen."
}' await fetch(`https://sandbox.api.lendeasy.ai /v1/servicing/cases/${caseId}/hardship/evidence/replacement-requests` , {
method: "POST" ,
headers: { Authorization: `Bearer ${token}` , "LendEasy-Tenant" : tenant, "Idempotency-Key" : idempotencyKey, "Content-Type" : "application/json" },
body: JSON.stringify({
"reasonCode": "SANITIZATION_INCOMPLETE",
"note": "Certificate arrived as a photograph of a screen."
}),
});requests.post(
f"https://sandbox.api.lendeasy.ai /v1/servicing/cases/{case_id}/hardship/evidence/replacement-requests" ,
headers={"Authorization" : f"Bearer {token}" , "LendEasy-Tenant" : tenant, "Idempotency-Key" : idempotency_key},
json={
"reasonCode": "SANITIZATION_INCOMPLETE",
"note": "Certificate arrived as a photograph of a screen."
},
)200 403 404 409
{
"cycleNo": 2 ,
"invitationId": "inv_5N1K",
"deliveryStatus": "QUEUED"
}{
"developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
"httpStatusCode": "403",
"defaultUserMessage": "The request could not be applied.",
"userMessageGlobalisationCode": "error.msg.not.authorized",
"errors": []
}{
"developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
"httpStatusCode": "404",
"defaultUserMessage": "The request could not be applied.",
"userMessageGlobalisationCode": "error.msg.resource.not.found",
"errors": []
}{
"developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
"httpStatusCode": "409",
"defaultUserMessage": "The request could not be applied.",
"userMessageGlobalisationCode": "idempotency.request.in.flight",
"errors": []
}