API Reference›Servicing Plane›Cookie›Read Cookie usage aggregates

Read Cookie usage aggregates

GEThttps://sandbox.api.lendeasy.ai/v1/servicing/cookie/admin/usageImplementedBearer token ·ADMIN_SERVICING_AI

Returns usage and quality aggregates with no question or answer bodies: daily counts, family and status breakdowns, usage buckets, action outcomes, feedback, and current quota windows. Stratified cells below the minimum count report turns as -1 with suppressed true.

Request

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

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

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

{
  "windowDays": 7,
  "daily": [
    {
      "day": "2026-07-25T00: 00:00Z",
      "directTurns": 42,
      "onlineTurns": 17,
      "declinedTurns": 2,
      "quotaRefused": 0,
      "providerFailures": 1,
      "acceptedAnswers": 55,
      "averageLatencyMs": 1840
    }
  ],
  "byFamily": [
    {
      "questionFamily": "CURRENT_PAYOFF",
      "answerPath": "DIRECT",
      "answerStatus": "GROUNDED",
      "turns": 28,
      "suppressed": false
    }
  ],
  "usageBuckets": [
    {
      "bucket": "ONLINE",
      "turns": 17
    }
  ],
  "actionOutcomes": [
    {
      "capabilityCode": "SAVE_CASE_NOTE",
      "status": "CONFIRMED",
      "proposals": 6
    }
  ],
  "feedback": [
    {
      "category": "HELPFUL",
      "entries": 12
    }
  ],
  "quotaWindows": [
    {
      "scopeKind": "TENANT",
      "scopeRef": "default",
      "windowStart": "2026-07-25T00: 00:00Z",
      "usedCount": 59
    }
  ]
}

{
  "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.
days optional in query	integer	Aggregation window in days.

Request

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

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

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

{
  "windowDays": 7,
  "daily": [
    {
      "day": "2026-07-25T00: 00:00Z",
      "directTurns": 42,
      "onlineTurns": 17,
      "declinedTurns": 2,
      "quotaRefused": 0,
      "providerFailures": 1,
      "acceptedAnswers": 55,
      "averageLatencyMs": 1840
    }
  ],
  "byFamily": [
    {
      "questionFamily": "CURRENT_PAYOFF",
      "answerPath": "DIRECT",
      "answerStatus": "GROUNDED",
      "turns": 28,
      "suppressed": false
    }
  ],
  "usageBuckets": [
    {
      "bucket": "ONLINE",
      "turns": 17
    }
  ],
  "actionOutcomes": [
    {
      "capabilityCode": "SAVE_CASE_NOTE",
      "status": "CONFIRMED",
      "proposals": 6
    }
  ],
  "feedback": [
    {
      "category": "HELPFUL",
      "entries": 12
    }
  ],
  "quotaWindows": [
    {
      "scopeKind": "TENANT",
      "scopeRef": "default",
      "windowStart": "2026-07-25T00: 00:00Z",
      "usedCount": 59
    }
  ]
}

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