---
title: "PATCH /billing/{tenantLocator}/delinquencies/{locator}"
method: PATCH
path: "/billing/{tenantLocator}/delinquencies/{locator}"
---

# PATCH /billing/{tenantLocator}/delinquencies/{locator}

`PATCH /billing/{tenantLocator}/delinquencies/{locator}`

## Request

- Base URL: `https://docs.socotra.com`
- URL: `https://docs.socotra.com/billing/{tenantLocator}/delinquencies/{locator}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/docs/billing/:tenantLocator/delinquencies/:locator/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `tenantLocator` string, uuid, required
- `locator` string, ulid, required

## Request body

- DelinquencyUpdateRequest
  - `graceEndAt` string, date-time

## Response `200`

OK

- DelinquencyResponse
  - `locator` string, ulid, required
  - `accountLocator` string, ulid, required
  - `delinquencyState` 'preGrace' | 'inGrace' | 'lapseTriggered' | 'settled' | 'lapseTransactionCreated', required
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `settings` DelinquencySettings, required
    - `lapseTransactionType` string, required
    - `gracePeriodDays` integer, required
    - `advanceLapseTo` 'draft' | 'validated' | 'priced' | 'underwritten' | 'accepted' | 'issued', required
    - `delinquencyLevel` 'policy' | 'invoice'
  - `timezone` string, required
  - `references` DelinquencyReference[]
    - `locator` string, ulid, required
    - `delinquencyLocator` string, ulid, required
    - `referenceLocator` string, ulid, required
    - `referenceType` 'policy' | 'invoice', required
    - `transactionLocator` string, ulid
    - `preemptingLapseTransactionLocator` string, ulid
  - `graceStartedAt` string, date-time
  - `graceEndAt` string, date-time
  - `lapseTransactionEffectiveDate` string, date-time
  - `configuredDelinquencyEvents` ConfiguredDelinquencyEvent[], required
    - `name` string, required
    - `offsetDays` number, required
    - `offsetBasis` 'gracePeriodStart' | 'gracePeriodEnd', required

---

[API](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi.md) - [All operations](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/socotra/apis/socotra-insurance-suite-openapi/revisions/6537d24b3693?raw)