---
title: "Close a case"
method: POST
path: "/cases/{id}/close"
tags: ["Cases"]
---

# Close a case

`POST /cases/{id}/close`

Closes a collection case with a specified close code.

**Use Case:**
Use this endpoint to formally close a case when collection is complete or cannot continue. The close code determines the reason and impacts reporting.

**Close Code Validation:**
- **Paid**: Requires at least one payment AND total payments >= outstanding amount
- **PartiallyPaid**: Requires at least one payment AND total payments < outstanding amount
- **All other codes**: No payment requirements

**Valid Close Codes:**
- **Paid** - Full payment received from debtor
- **PartiallyPaid** - Some payment received but not full amount
- **DebtorInsolventBankrupt** - Debtor declared bankruptcy or insolvent
- **DebtorUntraceable** - Unable to locate or contact debtor
- **DisputedLegalActionDeclinedByClient** - Debt disputed, creditor declined legal action
- **WithdrawnByClient** - Creditor requested case withdrawal
- **PreLegalExhaustedNoPayment** - All pre-legal attempts exhausted without payment
- **StatuteOfLimitationsExpired** - Legal time limit to collect has passed
- **SettlementRejectedByClient** - Proposed settlement rejected by creditor
- **UnresponsiveClient** - Creditor not responding to collection partner
- **Other** - Other reason (please provide comment)

## Path parameters

- `id` string, uuid, required

## Request body

- DebituraWebExternalApiContractsV1CasesRequestsCloseCaseRequest — Request to close a case
  - `closeCode` string, required — Close code/reason for closing the case. **Valid close codes:** - **Paid**: Full payment received from debtor - **PartiallyPaid**: Some payment received but not full amount - **DebtorInsolventBankrupt**: Debtor declared bankruptcy or insolvent - **DebtorUntraceable**: Unable to locate or contact debtor - **DisputedLegalActionDeclinedByClient**: Debt disputed, creditor declined legal action - **WithdrawnByClient**: Creditor requested case withdrawal - **PreLegalExhaustedNoPayment**: All pre-legal attempts exhausted without payment - **StatuteOfLimitationsExpired**: Legal time limit to collect has passed - **SettlementRejectedByClient**: Proposed settlement rejected by creditor - **UnresponsiveClient**: Creditor not responding to collection partner - **UneconomicalToPursue**: Recovery cost exceeds claim value - **Other**: Other reason (please provide comment)
  - `comment` string, nullable — Optional comment explaining the closure (recommended for 'Other' close code)

## Response `200`

Case closed successfully

- DebituraWebExternalApiContractsV1CasesCloseCaseResponse — Response after closing a case
  - `caseReference` string, nullable, required
  - `closeCode` string, nullable, required
  - `closeCodeDescription` string, nullable, required
  - `comment` string, nullable
  - `closedAt` string, date-time
  - `closedBy` DebituraWebExternalApiContractsV1CasesClosedByDto
    - `userId` integer
    - `userName` string, nullable, required
  - `finalOutstandingAmount` number, double
  - `totalPayments` number, double
  - `totalRecovered` number, double

## Other responses

- `400` — Invalid request (validation errors)
- `404` — Case not found or not assigned to you
- `500` — Server error occurred

---

[API](https://skmtc.net/debitura/apis/debitura-collection-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-collection-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-collection-partner-api/revisions/d0dcc5024bd1/schema)