List Transfers

Edit online

Retrieves a list of transfer requests for the specified wallet.

HTTP request
GET /wallets/{walletId}/transfers
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.
Path parameter
Parameter Type Required Description
walletId string Yes ID of the wallet. Length: 1 to 64 characters.
Query parameter
Parameter Type Required Description
limit integer No Maximum number of items to return. Default: 50. Valid range: 1 to 500.
paginationToken string No Token used to retrieve the next page of results. Returned as nextPageToken in the previous response. Minimum length: 1.
Request body
curl --request GET \
  --url 'https://api.digitalassets.ibm.com/wallets/{walletId}/transfers?limit=50' \
  --header 'Authorization: Bearer <token>'
Response
200: Success

Example response:

{
  "items": [
    {
      "id": "xfr-20g4k-nsdpo-mg6arrifgvid4orn",
      "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
      "network": "Algorand",
      "requester": {
        "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
        "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
      },
      "requestBody": {
        "kind": "Native",
        "to": "<string>",
        "amount": "<string>",
        "memo": "<string>",
        "priority": "Slow",
        "createDestinationAccount": true,
        "offer": true,
        "expiresAt": "2023-11-07T05:31:56Z",
        "externalId": "<string>",
        "travelRule": {
          "kind": "Notabene",
          "originator": {},
          "beneficiary": {},
          "beneficiaryVASPdid": "<string>",
          "beneficiaryProof": {}
        },
        "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
      },
      "metadata": {
        "asset": {
          "symbol": "<string>",
          "decimals": 123,
          "verified": true,
          "quotes": {
            "EUR": 123,
            "USD": 123
          }
        }
      },
      "status": "Pending",
      "dateRequested": "2023-04-14T20:41:28.715Z",
      "reason": "<string>",
      "txHash": "<string>",
      "fee": "<string>",
      "datePolicyResolved": "2023-04-14T20:41:28.715Z",
      "dateBroadcasted": "2023-04-14T20:41:28.715Z",
      "dateConfirmed": "2023-04-14T20:41:28.715Z",
      "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
      "externalId": "<string>",
      "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
    }
  ],
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "nextPageToken": "<string>"
}