# maturity-redemption

Source: https://docs.settlemint.com/docs/developers/api-integration/token-features/maturity-redemption
API reference for configuring the maturity-redemption token feature during token creation and triggering redemption after the maturity date.



The `maturity-redemption` token feature handles end-of-life redemption for fixed-income instruments. Configure during token creation; trigger maturity through the dedicated endpoint after the maturity date.

For the operator how-to, see [Maturity redemption how-to](/docs/operators/token-features/maturity-redemption). For the architecture model, see [Maturity redemption architecture](/docs/architects/components/token-features/maturity-redemption).

## Configuration during token creation [#configuration-during-token-creation]

Include `maturity-redemption` in the `featureConfigs` map of `POST /api/v2/token`:

```json
{
  "maturity-redemption": {
    "maturityDate": "2027-12-31",
    "denominationAsset": "0x...",
    "treasury": "0x...",
    "faceValue": "1000.00"
  }
}
```

| Parameter           | Type             | Required | Description                                                |
| ------------------- | ---------------- | -------- | ---------------------------------------------------------- |
| `maturityDate`      | ISO 8601 date    | Yes      | When the instrument matures. Immutable on most templates.  |
| `denominationAsset` | Ethereum address | Yes      | ERC-20 token face value pays in.                           |
| `treasury`          | Ethereum address | Yes      | Wallet that holds the denomination asset for redemption.   |
| `faceValue`         | Decimal string   | Yes      | Redemption amount per token, in `denominationAsset` units. |

## Trigger maturity [#trigger-maturity]

After `maturityDate`, post to the maturity endpoint to move the asset into redemption state:

```
POST /api/v2/token/{address}/features/maturity-redemption/trigger
```

The platform queues the on-chain transition. Pre-maturity transfers continue to evaluate against the asset's compliance modules; post-maturity transfers are blocked.

## Holder redemption [#holder-redemption]

Holders submit redemption through the standard burn flow once the maturity state is active. The platform transfers `faceValue × balance` of the denomination asset from `treasury` and burns the holder's position. Insufficient treasury balance fails the redemption.

## Related [#related]

* [Fixed treasury yield](/docs/developers/api-integration/token-features/fixed-treasury-yield) — often paired for coupon-paying bonds.
* [Token lifecycle](/docs/developers/api-integration/tokens/token-lifecycle)