API Reference›Servicing Plane›Supercases›List supercases

List supercases

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/supercasesImplementedBearer token ·MANAGE_SERVICING_SUPERCASE

Lists bounded structural summaries; detailed subcases are read through the case collection.

Request

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

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

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

{
  "items": [
    {
      "supercaseId": 8001,
      "externalSupercaseRef": "LE-SUPERCASE-8001",
      "supercaseType": "FEMA",
      "displayName": "July wildfire assistance",
      "status": "ACTIVE",
      "subcaseCaseTypeCode": "HARDSHIP",
      "sensitive": false,
      "subcaseCount": 12,
      "createdAt": "2026-07-24T16: 00:00Z",
      "lastUpdatedAt": "2026-07-25T18: 30:00Z"
    }
  ],
  "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.
supercaseType optional in query	string	Filter by supercase type. One of `GENERIC · FEMA · REMEDIATION`.
status optional in query	string	Repeat to include multiple states.
caseTypeCode optional in query	string	Filter by shared subcase type.
sensitive optional in query	boolean	Filter by sensitivity.
createdFrom optional in query	string	Inclusive timestamp lower bound.
createdTo optional in query	string	Exclusive timestamp upper bound.
limit optional in query	integer	Maximum rows to return; defaults to 50.
offset optional in query	integer	Zero-based row offset; defaults to 0.
sort optional in query	string	Allowlisted sort field for this collection.
order optional in query	string	Sort direction. One of `asc · desc`.

Request

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

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

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

{
  "items": [
    {
      "supercaseId": 8001,
      "externalSupercaseRef": "LE-SUPERCASE-8001",
      "supercaseType": "FEMA",
      "displayName": "July wildfire assistance",
      "status": "ACTIVE",
      "subcaseCaseTypeCode": "HARDSHIP",
      "sensitive": false,
      "subcaseCount": 12,
      "createdAt": "2026-07-24T16: 00:00Z",
      "lastUpdatedAt": "2026-07-25T18: 30:00Z"
    }
  ],
  "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": []
}