API Reference›LMS API›Customers›List customer history

List customer history

GEThttps://sandbox.api.lendeasy.ai/v1/customers/{customerId}/history Bearer token · READ_LMS_CUSTOMER_HISTORY

Returns the append-only change ledger for the customer and its children, newest first, with cursor paging. Without the sensitive read permission, protected values appear as redacted placeholders.

Request

curl https://sandbox.api.lendeasy.ai/v1/customers/$CUSTOMER_ID/history \
  -H "Authorization: Bearer $TOKEN"

await fetch(`https://sandbox.api.lendeasy.ai/v1/customers/${customerId}/history`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}` },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/customers/{customer_id}/history",
  headers={"Authorization": f"Bearer {token}"},
)

{
  "items": [
    {
      "historyId": "h_01JZ7M5K9Y",
      "occurredAt": "2026-09-15T14: 22:08Z",
      "category": "CONTACT_POINT",
      "action": "UPDATE",
      "subject": {
        "type": "CONTACT_POINT",
        "ref": "512",
        "href": "/v1/customers/412"
      },
      "summary": "Contact point updated",
      "changes": {
        "canReceiveSms": {
          "before": false,
          "after": true
        }
      },
      "actor": {
        "type": "STAFF",
        "ref": "9",
        "username": "ana.alvarez",
        "firstName": "Ana",
        "lastName": "Alvarez"
      },
      "correlationId": "corr_01JZ7M5K9X"
    }
  ],
  "nextCursor": null
}

{
  "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	Tenant selector: lowercase letters, digits, and hyphens, 1-64 characters. Exactly one instance; the only tenant selector honored.
customerId required in path	string	Stable opaque customer identifier.
cursor optional in query	string	Opaque cursor from the previous page.
limit optional in query	integer	Maximum events to return.
categories optional in query	string	Repeatable subject category filter. One of `PROFILE · ADDRESS · CONTACT_POINT · CONSENT · IDENTIFIER · DOCUMENT · NOTE · FORM_ENTRY · RESTRICTION · LOAN_PARTY`.
actions optional in query	string	Repeatable action filter within the selected categories.
occurredFrom optional in query	string	Inclusive lower bound; supply with occurredTo.
occurredTo optional in query	string	Exclusive upper bound; supply with occurredFrom.

Request

curl https://sandbox.api.lendeasy.ai/v1/customers/$CUSTOMER_ID/history \
  -H "Authorization: Bearer $TOKEN"

await fetch(`https://sandbox.api.lendeasy.ai/v1/customers/${customerId}/history`, {
  method: "GET",
  headers: { Authorization: `Bearer ${token}` },
});

requests.get(
  f"https://sandbox.api.lendeasy.ai/v1/customers/{customer_id}/history",
  headers={"Authorization": f"Bearer {token}"},
)

{
  "items": [
    {
      "historyId": "h_01JZ7M5K9Y",
      "occurredAt": "2026-09-15T14: 22:08Z",
      "category": "CONTACT_POINT",
      "action": "UPDATE",
      "subject": {
        "type": "CONTACT_POINT",
        "ref": "512",
        "href": "/v1/customers/412"
      },
      "summary": "Contact point updated",
      "changes": {
        "canReceiveSms": {
          "before": false,
          "after": true
        }
      },
      "actor": {
        "type": "STAFF",
        "ref": "9",
        "username": "ana.alvarez",
        "firstName": "Ana",
        "lastName": "Alvarez"
      },
      "correlationId": "corr_01JZ7M5K9X"
    }
  ],
  "nextCursor": null
}

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