API Reference›Servicing Plane›Promises›List case promises

List case promises

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/cases/{caseId}/promisesImplementedBearer token ·READ_SERVICING_CASE

Lists case promises and returns the current guardrail bounds used by the servicing workspace.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/cases/$CASE_ID/promises \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

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

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

{
  "items": [
    {
      "promiseId": 6101,
      "loanRef": "456",
      "planType": "SINGLE",
      "state": "ACTIVE",
      "amount": {
        "amount": 250,
        "currency": "USD"
      },
      "promiseDate": "2026-08-01",
      "reason": "Customer committed to pay on 2026-08-01.",
      "evaluatedAgainstAsOf": "2026-07-25T18: 30:00Z",
      "createdAt": "2026-07-25T18: 30:00Z"
    }
  ],
  "guardrail": {
    "maxHorizonDays": 30,
    "minAmountPercent": 25,
    "maxInstallments": 4,
    "outOfBoundsApprovalRole": "SUPERVISOR"
  },
  "limit": 50,
  "offset": 0,
  "hasMore": false
}

{
  "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.
caseId required in path	integer	Positive numeric case identifier.
limit optional in query	integer	Maximum rows to return; defaults to 50.
offset optional in query	integer	Zero-based row offset; defaults to 0.

Request

curl https://sandbox.api.lendeasy.ai/v1/servicing/cases/$CASE_ID/promises \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT"

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

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

{
  "items": [
    {
      "promiseId": 6101,
      "loanRef": "456",
      "planType": "SINGLE",
      "state": "ACTIVE",
      "amount": {
        "amount": 250,
        "currency": "USD"
      },
      "promiseDate": "2026-08-01",
      "reason": "Customer committed to pay on 2026-08-01.",
      "evaluatedAgainstAsOf": "2026-07-25T18: 30:00Z",
      "createdAt": "2026-07-25T18: 30:00Z"
    }
  ],
  "guardrail": {
    "maxHorizonDays": 30,
    "minAmountPercent": 25,
    "maxInstallments": 4,
    "outOfBoundsApprovalRole": "SUPERVISOR"
  },
  "limit": 50,
  "offset": 0,
  "hasMore": false
}

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