API Reference›Servicing Plane›Case documents›Retrieve invitation status

Retrieve invitation status

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/{invitationId}ImplementedBearer token ·READ_SERVICING_DOCUMENT

Returns the staff status view of one upload invitation, including lifecycle timestamps and any resulting document. No response on this resource ever carries the link secret.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/$INVITATION_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/${invitationId}`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}`, "LendEasy-Tenant": tenant },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/{invitation_id}",
  headers={"Authorization": f"Bearer {token}", "LendEasy-Tenant": tenant},
)

{
  "invitationId": 6001,
  "invitationRef": "LE-UPL-6001",
  "caseId": 1001,
  "evidenceType": "MEDICAL_CERTIFICATE",
  "purposeCode": "HARDSHIP_MEDICAL_LEAVE_EVIDENCE",
  "state": "DELIVERED",
  "issuedAt": "2026-07-25T18: 40:00Z",
  "expiresAt": "2026-08-01T18: 40:00Z",
  "deliveredAt": "2026-07-25T18: 41:00Z",
  "openedAt": null,
  "uploadedAt": null,
  "documentId": null,
  "localeCode": "en"
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "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": []
}

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.
invitationId required in path	string	Stable opaque invitation identifier.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/$INVITATION_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/${invitationId}`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}`, "LendEasy-Tenant": tenant },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/document-invitations/{invitation_id}",
  headers={"Authorization": f"Bearer {token}", "LendEasy-Tenant": tenant},
)

{
  "invitationId": 6001,
  "invitationRef": "LE-UPL-6001",
  "caseId": 1001,
  "evidenceType": "MEDICAL_CERTIFICATE",
  "purposeCode": "HARDSHIP_MEDICAL_LEAVE_EVIDENCE",
  "state": "DELIVERED",
  "issuedAt": "2026-07-25T18: 40:00Z",
  "expiresAt": "2026-08-01T18: 40:00Z",
  "deliveredAt": "2026-07-25T18: 41:00Z",
  "openedAt": null,
  "uploadedAt": null,
  "documentId": null,
  "localeCode": "en"
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "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": []
}