---
title: "Create banking asset redemption"
method: PUT
path: "/v2/issuer/{issuer_id}/assets/{asset_id}/redemption"
tags: ["Assets"]
---

# Create banking asset redemption

`PUT /v2/issuer/{issuer_id}/assets/{asset_id}/redemption`

## Request

- Base URL: `https://sandbox.pismolabs.io/passport`
- URL: `https://sandbox.pismolabs.io/passport/v2/issuer/{issuer_id}/assets/{asset_id}/redemption`
- Auth: none declared

Create a banking asset redemption. A banking asset redemption is the repayment of the original value of the asset to the investor.

If the request succeeds, this endpoint generates an [Asset redeemed](https://developers.pismo.io/events/docs/assets-asset-redemption-1) event and an [Asset status changed](https://developers.pismo.io/events/docs/assets-asset-status-change-1) event.
If it fails, it generates an [Asset redemption failed](https://developers.pismo.io/events/docs/assets-asset-redemption-failure-1) event.

## Path parameters

- `issuer_id` string, required
- `assetId` string, required

## Headers

- `x-cid` string

## Request body

- AssetRedemption
  - `units` integer, required: Number of asset units
  - `document_number` string, required: Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.
  - `external_id` string, required: Provider-generated unique ID for client monitoring and tracking
  - `redemption_date` string: Redemption date, format = yyyy/mm/dd
  - `deposit_number` integer: Deposit number

## Response `202`

OK

- AssetRegistrationResponse
  - `asset_id` string, required: Asset ID. This ID is client-generated. It must be between 1 and 128 characters long and consist of only the characters [a-z,A-Z,0-9,-,:].
  - `message` string, required: Message

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `404`: Not Found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/platform-authentication.md) - [All operations](https://skmtc.dev/pismo/apis/platform-authentication/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/platform-authentication/revisions/935b62e16de4?raw)