v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Assets

Migrate banking asset

If the request succeeds, this endpoint generates an <a href="https://json-schemas.data.pismo.io/docs/assets/asset_block-1.html">asset_block-1</a> event. If it fails, it generates an <a href="https://json-schemas.data.pismo.io/docs/assets/asset_block_failure-1.html">asset_block_failure-1</a> event.

post/v1/issuer/{issuer_id}/assets/{asset_id}/migrate

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.

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.

Request body

asset_type'cdb' | 'rdb'

Asset type, cdb (certificate of deposit) or rdb (bank deposit receipt)

document_numberstring

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_numberinteger

Deposit number

Example request

{
  "asset_type": "cdb",
  "document_number": "7777888hh",
  "deposit_number": 567339022
}

Response

ACCEPTED

asset_idstring

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,-,:].

messagestring

Message

Example response

{
  "asset_id": "6ea8094b-73ba-4737-93ad-370c27c54813",
  "message": "Credit rights update request is being processed"
}