API Reference›Servicing Plane›Cookie›Retrieve a Cookie turn

Retrieve a Cookie turn

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/cookie/turns/{turnId}ImplementedBearer token ·REQUEST_SERVICING_COOKIE

Returns one turn’s terminal result and accepted answer for polling or reopening a thread. Resolving the turn re-checks case visibility, so a turn reference is never a way around the case read boundary.

Request

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

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

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

{
  "turnId": 8201,
  "threadId": 8101,
  "questionFamily": "CURRENT_PAYOFF",
  "answerPath": "DIRECT",
  "answerStatus": "GROUNDED",
  "terminalAt": "2026-07-25T18: 40:00Z",
  "correlationRef": "ck-7f3a2c",
  "answer": {
    "answerStatus": "GROUNDED",
    "answerKind": "VERIFIED_FACT",
    "answer": "The payoff for loan 456 today is 1,254.10 USD.",
    "assertions": [
      {
        "claimType": "PAYOFF_TOTAL",
        "text": "Payoff total as of today",
        "value": "1254.10 USD",
        "derivation": "SOURCED",
        "sourceRefs": [
          "loan: 456"
        ]
      }
    ],
    "citations": [
      {
        "type": "LOAN",
        "publicRef": "loan: 456",
        "label": "Loan 456 servicing record",
        "sourceTime": "2026-07-25T18: 40:00Z",
        "freshness": "CURRENT",
        "deepLink": "/loans/456"
      }
    ],
    "missingFacts": [],
    "warnings": [],
    "attentionItems": [],
    "proposedActions": []
  }
}

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

Request

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

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

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

{
  "turnId": 8201,
  "threadId": 8101,
  "questionFamily": "CURRENT_PAYOFF",
  "answerPath": "DIRECT",
  "answerStatus": "GROUNDED",
  "terminalAt": "2026-07-25T18: 40:00Z",
  "correlationRef": "ck-7f3a2c",
  "answer": {
    "answerStatus": "GROUNDED",
    "answerKind": "VERIFIED_FACT",
    "answer": "The payoff for loan 456 today is 1,254.10 USD.",
    "assertions": [
      {
        "claimType": "PAYOFF_TOTAL",
        "text": "Payoff total as of today",
        "value": "1254.10 USD",
        "derivation": "SOURCED",
        "sourceRefs": [
          "loan: 456"
        ]
      }
    ],
    "citations": [
      {
        "type": "LOAN",
        "publicRef": "loan: 456",
        "label": "Loan 456 servicing record",
        "sourceTime": "2026-07-25T18: 40:00Z",
        "freshness": "CURRENT",
        "deepLink": "/loans/456"
      }
    ],
    "missingFacts": [],
    "warnings": [],
    "attentionItems": [],
    "proposedActions": []
  }
}

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