# Renew contract

> Renews a contract by extending its end date

`POST https://api.light.inc/v1/contracts/{contractId}/renew`

## Note

Only from ACTIVE , and only for a contract that has an endDate ( CONTRACT_CANNOT_RENEW_WITH_NO_END_DATE ). nextEndDate must be on or after both the current endDate and today. It sets endDate , sets renewalDate to nextRenewalDate or clears it when omitted , and extends only the lines whose billingEnd equaled the old endDate ; lines ending earlier are left alone. The renewal re-runs every publish validation.

## Authorization

- API key
- Bearer token

See https://light.inc/docs/getting-started/authentication.

## Path parameters

- `contractId` (string, uuid, required)

## Header parameters

- `X-Idempotency-Key` (string)

## Request body

`application/json;charset=UTF-8`


```json
{
  "nextEndDate": "2026-01-15",
  "nextRenewalDate": "2026-01-15"
}
```

Values above are generated from the schema: the shapes and types are real, the values are placeholders, and fields that exclude each other are all shown. Do not send it unchanged.

## Response

- `terminatedAt` — The termination **date** at 00:00 UTC, not the moment the termination was entered.
- `state` — API-created contracts start in `DRAFT` and `reset` returns them there; `CREATED` only occurs for PDFs uploaded for parsing in the app. `PENDING_TERMINATION` is a scheduled termination; `TERMINATED` is terminal.
- `lines` — `[]` on the list endpoint; populated only by `GET /v1/contracts/{contractId}`.
- `lines.priceOverwrite` — The **line total** before discount, in the smallest denomination — not a unit price. It stands in for `quantity` × the product's price, and the unit price Light displays is this figure divided by `quantity`. `null` means the line is priced from the product. The model carries no computed amounts (no net, discount or tax figure), so a line's arithmetic is this field, `quantity` and `discount`.

```json
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "startDate": "2026-01-15",
  "endDate": "2026-01-15",
  "activatedAt": "2026-01-15T09:30:00Z",
  "terminatedAt": "2026-01-15T09:30:00Z",
  "terminationReason": "string",
  "terminationReasonType": "FINISHED",
  "renewalDate": "2026-01-15",
  "companyEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "invoiceTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "currency": "USD",
  "estimatedAmount": 100000,
  "paymentType": "AIRWALLEX",
  "payeeBankAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "billingStart": "2026-01-15",
  "netTerms": 0,
  "invoiceLeadDays": 0,
  "description": "string",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "state": "CREATED",
  "areLinesWithTax": true,
  "lines": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "contractId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "billingStart": "2026-01-15",
      "billingEnd": "2026-01-15",
      "billingRecurrence": "ONE_TIME",
      "accountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "taxCodeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "avataxCode": "string",
      "discount": {
        "startDate": "2026-01-15",
        "endDate": "2026-01-15",
        "type": "PERCENTAGE"
      },
      "quantity": 0,
      "priceOverwrite": 100000,
      "productNameOverwrite": "string",
      "amortizationTemplateId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "amortizationStartDate": "2026-01-15",
      "amortizationEndDate": "2026-01-15",
      "aiValueSuggestions": [
        {
          "field": "string",
          "fieldValues": [
            "string"
          ],
          "reasoning": "string"
        }
      ],
      "customProperties": [
        {
          "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "groupInternalName": "string",
          "values": [
            {}
          ]
        }
      ],
      "createdAt": "2026-01-15T09:30:00Z",
      "updatedAt": "2026-01-15T09:30:00Z"
    }
  ],
  "taxEngineName": "AVATAX",
  "externalId": "string",
  "externalSource": "HUBSPOT",
  "customProperties": [
    {
      "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "groupInternalName": "string",
      "values": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "groupId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "groupInternalName": "string",
          "companyId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "internalName": "string",
          "label": "string",
          "context": "string",
          "createdAt": "2026-01-15T09:30:00Z",
          "updatedAt": "2026-01-15T09:30:00Z"
        }
      ]
    }
  ],
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z"
}
```

Values above are generated from the schema: the shapes and types are real, the values are placeholders.

## Code

```bash
# Set LIGHT_IDEMPOTENCY_KEY to a key saved for this operation; reuse it on retries.
curl -X POST "https://api.light.inc/v1/contracts/3c90c3cc-0d44-4b50-8888-8dd25736052a/renew" \
  -H "Authorization: Basic YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: ${LIGHT_IDEMPOTENCY_KEY:?Set a saved key for this operation}" \
  -d '{
  "nextEndDate": "2026-01-15",
  "nextRenewalDate": "2026-01-15"
}'
```

---

Full page: https://light.inc/docs/api-reference/v1--contracts/renew-contract · Index: https://light.inc/docs/llms.txt
