---
title: "Expire a commitment-linked prepayment"
method: PUT
path: "/prepayments/{prepaymentId}/expire"
tags: ["Commitments"]
---

# Expire a commitment-linked prepayment

`PUT /prepayments/{prepaymentId}/expire`

Expires a single commitment-linked prepayment and returns the updated prepayment state.

After the prepayment is expired, it does not participate in future drawdown.

## Path parameters

- `prepaymentId` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Track-Id` string
- `Zuora-Version` string

## Response `200`

OK

- ExpirePrepaymentResponse
  - `processId` string — The ID of the process that handles the operation.
  - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`.
    - `code` string — The error code of response.
    - `message` string — The detail information of the error response
  - `requestId` string, uuid — Unique identifier of the request.
  - `success` boolean — Indicates whether the call succeeded.
  - `id` string — The ID of the prepayment.
  - `prepaymentDefinitionId` string — The ID of the prepayment definition associated with the prepayment.
  - `commitmentId` string — The ID of the commitment associated with the prepayment.
  - `commitmentNumber` string — The number of the commitment associated with the prepayment.
  - `commitmentScheduleId` string — The ID of the commitment schedule associated with the prepayment.
  - `commitmentPeriodId` string — The ID of the commitment period associated with the prepayment.
  - `amount` number — The original amount of the prepayment.
  - `billedAmount` number — The total billed amount of the prepayment.
  - `spendAmount` number — The total spend amount of the prepayment.
  - `balance` number — The remaining balance of the prepayment.
  - `overageAmount` number — The overage amount of the prepayment.
  - `currency` string — The currency of the prepayment amounts.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)