API Reference›Servicing Plane›Cases›Create a case

Create a case

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/cases Bearer token · CREATE_CASE

Creates or deduplicates a durable servicing matter and resolves its workflow version, queue, service levels, and first tasks.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/cases \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "caseType": "collections",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "source": "delinquency_monitor",
  "sourceReference": "signal_2027-05-01_HBR",
  "reasonCode": "installment_past_due",
  "priority": "high"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/cases`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "caseType": "collections",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "source": "delinquency_monitor",
  "sourceReference": "signal_2027-05-01_HBR",
  "reasonCode": "installment_past_due",
  "priority": "high"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/cases",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "caseType": "collections",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "source": "delinquency_monitor",
  "sourceReference": "signal_2027-05-01_HBR",
  "reasonCode": "installment_past_due",
  "priority": "high"
},
)

{
  "caseId": "case_HBR_COL_51",
  "caseType": "collections",
  "status": "open",
  "stage": "contact_strategy",
  "priority": "high",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "queueId": "queue_early_collections",
  "nextAction": "evaluate_contact_eligibility",
  "version": 6
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

Path & query parameters

Field	Type	Description
Idempotency-Key required in header	string	Stable key for this one logical mutation. Reuse it for retries; reusing it with a different request returns 409.

Body parameters

Field	Type	Description
caseType required	string
customerId required	string	Stable opaque customer identifier.
loanIds required	array<string>
source required	string	System or actor that originated the record.
sourceReference required	string
reasonCode required	string	Configured structured reason code.
priority required	string

Recipes using this endpoint

📘 Handle a delinquency case →

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/cases \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "caseType": "collections",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "source": "delinquency_monitor",
  "sourceReference": "signal_2027-05-01_HBR",
  "reasonCode": "installment_past_due",
  "priority": "high"
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/cases`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "caseType": "collections",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "source": "delinquency_monitor",
  "sourceReference": "signal_2027-05-01_HBR",
  "reasonCode": "installment_past_due",
  "priority": "high"
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/cases",
  headers={"Authorization": f"Bearer {token}", "Idempotency-Key": idempotency_key},
  json={
  "caseType": "collections",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "source": "delinquency_monitor",
  "sourceReference": "signal_2027-05-01_HBR",
  "reasonCode": "installment_past_due",
  "priority": "high"
},
)

{
  "caseId": "case_HBR_COL_51",
  "caseType": "collections",
  "status": "open",
  "stage": "contact_strategy",
  "priority": "high",
  "customerId": "cus_72P0MAYA",
  "loanIds": [
    "loan_harbor_7X2K"
  ],
  "queueId": "queue_early_collections",
  "nextAction": "evaluate_contact_eligibility",
  "version": 6
}

{
  "type": "https://docs.lendeasy.ai/errors/unauthorized",
  "title": "Unauthorized",
  "status": 401,
  "code": "unauthorized",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/forbidden",
  "title": "Forbidden",
  "status": 403,
  "code": "forbidden",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/version_conflict",
  "title": "Version Conflict",
  "status": 409,
  "code": "version_conflict",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/validation_error",
  "title": "Validation Error",
  "status": 422,
  "code": "validation_error",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}

{
  "type": "https://docs.lendeasy.ai/errors/rate_limited",
  "title": "Rate Limited",
  "status": 429,
  "code": "rate_limited",
  "detail": "The request could not be applied.",
  "requestId": "req_01J2R8M6YQ3C7K2N"
}