---
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`

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.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)