---
title: "List banking asset redemptions"
method: GET
path: "/v1/issuer/{issuer_id}/assets/{asset_id}/redemption"
tags: ["Assets"]
---

# List banking asset redemptions

`GET /v1/issuer/{issuer_id}/assets/{asset_id}/redemption`

## Request

- Base URL: `https://sandbox.pismolabs.io/assets-accrual`
- URL: `https://sandbox.pismolabs.io/assets-accrual/v1/issuer/{issuer_id}/assets/{asset_id}/redemption`
- Auth: HTTP bearer

List banking asset redemptions using asset and issuer IDs

## Path parameters

- `issuer_id` string, required
- `asset_id` string, required

## Query parameters

- `page` integer, required
- `perPage` integer, required
- `externalId` string, required
- `beginDate` string, date
- `endDate` string, date

## Headers

- `x-cid` string

## Response `200`

OK

- AssetRedemptionsResponse
  - `current_page` number: Current page
  - `per_page` integer: Number of items per page, default is 10.
  - `pages` integer: Total number of pages, default is 1.
  - `total_items` number: Total number of items
  - `items` object[]
    - `redemption_id` string: Redemption ID
    - `asset_id` string: 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,-,:].
    - `issuer_id` string: Issuer ID. For more information, see [issuer identification number](https://www.investopedia.com/terms/i/issuer-identification-number-iin.asp)
    - `document_number` string: A government document number, such as a social security number (US). Must be numeric with 11-14 digits.
    - `deposit_number` integer: Deposit number
    - `redeemed_units` number: Number of redeemed units
    - `currency` string: 1SO 4217 currency code
    - `redemption_date` string: Redemption date, format = yyyy/mm/dd
    - `created_at` string: Date/time (UTC) asset registered on Pismo platform
    - `external_id` string: Client-provided external asset ID. No longer than 128 alphanumeric characters.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/pismo/apis/banking-assets.md) - [All operations](https://skmtc.dev/pismo/apis/banking-assets/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/banking-assets/revisions/d140d7254f7d?raw)