Get Pending Token Airdrops

Returns pending token airdrops that have been received by an account.

This method will use 15 Compute Units.

Get pending token airdrops received by an account

Returns pending token airdrops that have been received by an account.

GEThttps://mainnet.hedera.validationcloud.io/v1/<YOUR_API_KEY>/api/v1/accounts/{idOrAliasOrEvmAddress}/airdrops/pending

Path parameters

idOrAliasOrEvmAddress*string

Account alias or account id or evm address

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)

The maximum number of items to return

Example: 2

orderenum

The order in which items are listed

Example: "desc"

ascdesc

sender.idEntityIdQuery (string)

The ID of the sender to return information for

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

serialnumberstring

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

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

token.idEntityIdQuery (string)

The ID of the token to return information for

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

Response

Body

airdropsTokenAirdrops (array of TokenAirdrop (object))

amount*integer (int64)

receiver_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.0.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

sender_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.0.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

serial_numbernullable integer (int64)

Example: 1

timestamp*TimestampRange (object)

A timestamp range an entity is valid for

fromall of

Timestamp (string)

A Unix timestamp in seconds.nanoseconds format

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The inclusive from timestamp in seconds

toall of

nullable TimestampNullable (string)

A Unix timestamp in seconds.nanoseconds format

Example: "1586567700.453054000"

Pattern: ^\d{1,10}(\.\d{1,9})?$

any

The exclusive to timestamp in seconds

token_id*nullable EntityId (string)

Network entity ID in the format of shard.realm.num

Example: "0.0.2"

Pattern: ^\d{1,10}\.\d{1,10}\.\d{1,10}$

linksLinks (object)

nextnullable string

Request

Response