List Offers

Edit online

Lists all offers received on a specific wallet.

HTTP request
GET /wallets/{walletId}/offers
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. This value is returned as nextPageToken in the previous response. Minimum length: 1.
Request body
curl --request GET \
  --url 'https://api.digitalassets.ibm.com//wallets/{walletId}/offers?limit=50' \
  --header 'Authorization: Bearer <token>'
Response
200: Success

Example response:

{
  "items": [
    {
      "id": "offer-3ugfu-o8duj-vqu770ckmg7ilhp4",
      "orgId": "or-30tnh-itmjs-s235s5ontr3r23h2",
      "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
      "network": "Algorand",
      "kind": "Native",
      "metadata": {
        "asset": {
          "symbol": "<string>",
          "decimals": 123,
          "verified": true,
          "quotes": {
            "EUR": 123,
            "USD": 123
          }
        }
      },
      "txHash": "<string>",
      "status": "Pending",
      "from": "<string>",
      "to": "<string>",
      "value": "<string>",
      "timestamp": "2023-04-14T20:41:28.715Z",
      "expiresAt": "2023-04-14T20:41:28.715Z",
      "memo": "<string>",
      "settlementTransactionId": "tx-583hu-sp2p7-slvb9nqpa3hd8bus",
      "dateSettled": "2023-04-14T20:41:28.715Z"
    }
  ],
  "nextPageToken": "<string>"
}