Get Outstanding Token Airdrops

Returns outstanding token airdrops that have been sent by an account.

This method will use 20 Compute Units.

---

Get outstanding token airdrops sent by an account

get

Returns outstanding token airdrops that have been sent by an account.

Path parameters

idOrAliasOrEvmAddressstringrequired

Account alias or account id or evm address

Example: {"value":"HIQQEXWKW53RKN4W6XXC4Q232SYNZ3SZANVZZSUME5B5PRGXL663UAQA"}

Pattern: ^(\d{1,10}\.){0,2}(\d{1,10}|(0x)?[A-Fa-f0-9]{40}|(?:[A-Z2-7]{8})*(?:[A-Z2-7]{2}|[A-Z2-7]{4,5}|[A-Z2-7]{7,8}))$

Query parameters

limitinteger · int32 · min: 1 · max: 100 · default: 25optional

The maximum number of items to return

Example: 2

orderundefined · enum · default: "asc"optional

The order in which items are listed

Example: desc

Available options:

receiver.idstringoptional

The ID of the receiver to return information for

Example: {"summary":"--","value":""}

Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$

serialnumberstringoptional

The nft serial number (64 bit type). Requires a tokenId value also be populated.

Example: {"summary":"--","value":""}

Pattern: ^((eq|gt|gte|lt|lte):)?\d{1,19}?$

token.idstringoptional

The ID of the token to return information for

Example: {"summary":"--","value":""}

Pattern: ^((gte?|lte?|eq|ne)\:)?(\d{1,10}\.\d{1,10}\.)?\d{1,10}$

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mainnet.hedera.validationcloud.io/v1/<YOUR_API_KEY>/api/v1/accounts/{idOrAliasOrEvmAddress}/airdrops/outstanding'

200

400

404

200

{
  "airdrops": [
    {
      "amount": 10,
      "receiver_id": "0.0.15",
      "sender_id": "0.0.10",
      "serial_number": null,
      "timestamp": {
        "from": "1651560386.060890949",
        "to": "1651560386.661997287"
      },
      "token_id": "0.0.99"
    }
  ],
  "links": {
    "next": null
  }
}

OK