API Reference›Servicing Plane›Scheduled callbacks›Retrieve a scheduled callback

Retrieve a scheduled callback

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/scheduled-callbacks/{taskId}ImplementedBearer token ·READ_SERVICING_TASK

Returns one callback with its schedule-change history and its allocation-offer history. Window times carry the borrower’s scheduled zone; completeBy is the internal task deadline, kept separate from the promised window.

Request

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

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

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

{
  "taskId": 2001,
  "caseId": 1001,
  "interactionId": 3001,
  "status": "RESERVED",
  "interactionStatus": "SCHEDULED",
  "priority": "HIGH",
  "queueCode": "COLLECTIONS",
  "summary": "Customer asked to be called back about the missed payment.",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "contactPointRef": "phone-1",
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "scheduledZoneId": "America/Chicago",
  "availableAt": "2026-07-26T15: 00:00Z",
  "completeBy": "2026-07-26T15: 30:00Z",
  "reservedByWorkerId": 4101,
  "reservedByWorkerName": "Maria Agent",
  "reservationExpiresAt": "2026-07-26T15: 05:00Z",
  "promiseIndicator": "IN_WINDOW",
  "scheduleHistory": [
    {
      "changeType": "SCHEDULED",
      "newWindowStart": "2026-07-26T15: 00:00Z",
      "newWindowEnd": "2026-07-26T15: 30:00Z",
      "newZoneId": "America/Chicago",
      "reasonCode": "BORROWER_REQUEST",
      "actorType": "HUMAN",
      "actorRef": "4101",
      "consentReplaced": false,
      "reservationReleased": false,
      "at": "2026-07-25T18: 40:00Z"
    }
  ],
  "reservationHistory": [
    {
      "workerId": 4101,
      "workerName": "Maria Agent",
      "state": "OPEN",
      "offeredAt": "2026-07-26T15: 00:05Z",
      "expiresAt": "2026-07-26T15: 05:00Z",
      "trigger": "TASK_ACTIVATED",
      "reason": "Carrying the least work of 3 available eligible workers",
      "candidateCount": 3
    }
  ]
}

{
  "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.
taskId required in path	integer	Positive numeric task identifier.

Request

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

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

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

{
  "taskId": 2001,
  "caseId": 1001,
  "interactionId": 3001,
  "status": "RESERVED",
  "interactionStatus": "SCHEDULED",
  "priority": "HIGH",
  "queueCode": "COLLECTIONS",
  "summary": "Customer asked to be called back about the missed payment.",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "contactPointRef": "phone-1",
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "scheduledZoneId": "America/Chicago",
  "availableAt": "2026-07-26T15: 00:00Z",
  "completeBy": "2026-07-26T15: 30:00Z",
  "reservedByWorkerId": 4101,
  "reservedByWorkerName": "Maria Agent",
  "reservationExpiresAt": "2026-07-26T15: 05:00Z",
  "promiseIndicator": "IN_WINDOW",
  "scheduleHistory": [
    {
      "changeType": "SCHEDULED",
      "newWindowStart": "2026-07-26T15: 00:00Z",
      "newWindowEnd": "2026-07-26T15: 30:00Z",
      "newZoneId": "America/Chicago",
      "reasonCode": "BORROWER_REQUEST",
      "actorType": "HUMAN",
      "actorRef": "4101",
      "consentReplaced": false,
      "reservationReleased": false,
      "at": "2026-07-25T18: 40:00Z"
    }
  ],
  "reservationHistory": [
    {
      "workerId": 4101,
      "workerName": "Maria Agent",
      "state": "OPEN",
      "offeredAt": "2026-07-26T15: 00:05Z",
      "expiresAt": "2026-07-26T15: 05:00Z",
      "trigger": "TASK_ACTIVATED",
      "reason": "Carrying the least work of 3 available eligible workers",
      "candidateCount": 3
    }
  ]
}

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