API Reference›Servicing Plane›Email threads›Retrieve an email thread

Retrieve an email thread

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/email-threads/{threadId}ImplementedBearer token ·READ_SERVICING_INTERACTION

Returns one thread projection including association evidence, acknowledgement state, and the server-derived replyable flag. Replies are possible only on an open thread with an exact verified contact association.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/email-threads/$THREAD_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

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

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

{
  "threadId": 3501,
  "customerRef": "123",
  "caseId": 1001,
  "subject": "Question about my July payment",
  "status": "ACTIVE",
  "associationState": "EXACT_VERIFIED_CONTACT",
  "associationEvidence": "VERIFIED_EMAIL_CONTACT",
  "mailboxMode": "MONITORED",
  "actionNeeded": true,
  "lastMessageAt": "2026-07-25T18: 40:00Z",
  "messageCount": 3,
  "closedAt": null,
  "reopenedAt": null,
  "acknowledgementPolicyCode": "SAFE_ACK",
  "acknowledgementSentAt": "2026-07-25T18: 21:00Z",
  "replyable": true
}

{
  "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.
threadId required in path	string	Stable opaque thread identifier.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/email-threads/$THREAD_ID \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

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

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

{
  "threadId": 3501,
  "customerRef": "123",
  "caseId": 1001,
  "subject": "Question about my July payment",
  "status": "ACTIVE",
  "associationState": "EXACT_VERIFIED_CONTACT",
  "associationEvidence": "VERIFIED_EMAIL_CONTACT",
  "mailboxMode": "MONITORED",
  "actionNeeded": true,
  "lastMessageAt": "2026-07-25T18: 40:00Z",
  "messageCount": 3,
  "closedAt": null,
  "reopenedAt": null,
  "acknowledgementPolicyCode": "SAFE_ACK",
  "acknowledgementSentAt": "2026-07-25T18: 21:00Z",
  "replyable": true
}

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