v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Assets

List banking asset redemptions

List banking asset redemptions using asset and issuer IDs

get/v1/issuer/{issuer_id}/assets/{asset_id}/redemption

Path parameters

issuer_idstring required

Issuer ID. For more information, refer to issuer identification number

assetIdstring required

Image asset ID. This is the image_asset_id field returned from the Get eligible token requestors endpoint.

Query parameters

pageinteger

Example:3

Page number

perPageinteger

Example:10

Maximum number of items per page

externalIdstring required

Client-provided external asset ID. No longer than 128 alphanumeric characters.

beginDatestring date

Date asset was issued

endDatestring date

Date asset was redeemed, format = yyyy-mm-dd.

Headers

x-cidstring

The Correlation IDentifier field is used to link related API requests and events. The x-cid can help the Pismo engineering team track everything related to a call. You can find the x-cid field in the response header from an API endpoint call.

If this field isn't passed, one is automatically generated.

Response

current_pageinteger

Current page number

per_pageinteger

Maximum number of items per page

pagesinteger

Number of pages

total_itemsinteger

Total number of items

Example response

{
  "current_page": 1,
  "per_page": 15,
  "pages": 10,
  "total_items": 100,
  "items": [
    {
      "redemption_id": "d72a234c-9cbe-4ad0-9b7c-8dd18e958bc0",
      "asset_id": "6ea8094b-73ba-4737-93ad-370c27c54813",
      "issuer_id": "98400-0-0d",
      "document_number": "7777888hh",
      "deposit_number": 567339022,
      "redeemed_units": 10,
      "currency": "USD",
      "redemption_date": "2023/03/30",
      "created_at": "2024-09-12T16:46:16.43663522",
      "external_id": "ABC123456"
    }
  ]
}