# Open a delinquency case

Opens a collections case against a deal that is behind. Body: `definitionKey` and `rowId` name the record — both required — plus `severity` (early, moderate, severe, critical), `daysDelinquent`, `missedPaymentsCount`, `missedAmount`, `totalOutstanding` (decimal strings) and `internalNotes`. A deal already carrying a live case answers 409: two open rows on one deal is a double count, not a second problem. There is no detector behind this — a person states it, or `post_servicing_delinquencies_sweep` finds them from the ledger.

Access class: `workspace`.

## Endpoint

`POST /v1/servicing/delinquencies`

## Request body

Content type: `application/json`.

```json
{
  "body": {
    "daysDelinquent": 1,
    "definitionKey": "string",
    "internalNotes": "string",
    "missedAmount": "string",
    "missedPaymentsCount": 1,
    "rowId": "",
    "severity": "string",
    "totalOutstanding": "string"
  },
  "params": {},
  "query": {}
}
```

## Responses

### 201

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "bucket": "string",
    "contactAttempts": 1,
    "createdAt": "string",
    "daysDelinquent": 1,
    "id": "",
    "internalNotes": "string",
    "lastContactAt": "string",
    "lastContactMethod": "string",
    "lastContactResult": "string",
    "missedAmount": "string",
    "missedPaymentsCount": 1,
    "openedBy": 1,
    "resolutionAmount": "string",
    "resolutionNotes": "string",
    "resolvedAt": "string",
    "rowId": "",
    "severity": "string",
    "source": "string",
    "startedAt": "string",
    "status": "string",
    "sweptAt": "string",
    "totalOutstanding": "string",
    "updatedAt": "string"
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```