---
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/passport`
- URL: `https://sandbox.pismolabs.io/passport/v1/issuer/{issuer_id}/assets/{asset_id}/redemption`
- Auth: none declared

List banking asset redemptions using asset and issuer IDs

## Path parameters

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

## Query parameters

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

## Headers

- `x-cid` string

## Response `200`

OK

- AssetRedemptionsResponse
  - `current_page` integer: Current page number
  - `per_page` integer: Maximum number of items per page
  - `pages` integer: Number of pages
  - `total_items` integer: 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: 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.
    - `deposit_number` integer: Deposit number
    - `redeemed_units` number: Number of redeemed units
    - `currency` string: ISO-4217 currency code.
    - `redemption_date` string: Redemption date, format = yyyy/mm/dd
    - `created_at` string, date-time: Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM.
    - `external_id` string: Provider-generated unique ID for client monitoring and tracking

## 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)