Get NFT Allowances by Account

Returns an account's non-fungible token (NFT) allowances.

This method will use 15 Compute Units.

Get non fungible token allowances for an account

Returns an account's non-fungible token allowances.

Ordering

The order is governed by a combination of the account ID and the token ID values, with account ID being the parent column. The token ID value governs its order within the given account ID.

Note: The default order for this API is currently ascending. The account ID can be the owner or the spender ID depending upon the owner flag.

Filtering

When filtering there are some restrictions enforced to ensure correctness and scalability.

The table below defines the restrictions and support for the endpoint

Query Param	Comparison Operator	Support	Description	Example
account.id	eq	Y	Single occurrence only.	?account.id=X
	ne	N
	lt(e)	Y	Single occurrence only.	?account.id=lte:X
	gt(e)	Y	Single occurrence only.	?account.id=gte:X
token.id	eq	Y	Single occurrence only. Requires the presence of an account.id parameter	?account.id=X&token.id=eq:Y
	ne	N
	lt(e)	Y	Single occurrence only. Requires the presence of an lte or eq account.id parameter	?account.id=lte:X&token.id=lt:Y
	gt(e)	Y	Single occurrence only. Requires the presence of an gte or eq account.id parameter	?account.id=gte:X&token.id=gt:Y

Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.

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

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

account.idEntityIdQuery (string)

The ID of the account to return information for

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

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}$

ownerboolean

When the owner value is true or omitted, the accountId path parameter will specify the ID of the owner, and the API will retrieve the allowances that the owner has granted to different spenders. Conversely, when the owner value is false, the accountId path parameter will indicate the ID of the spender who has an allowance, and the API will instead provide the allowances granted to the spender by different owners of those tokens.

Example: true

Response

Body

allowancesNftAllowances (array of NftAllowance (object))

approved_for_all*boolean

A boolean value indicating if the spender has the allowance to spend all NFTs owned by the given owner

Example: true

owner*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}$

spender*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}$

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

Get non fungible token allowances for an account

Returns an account's non-fungible token allowances.

Ordering

The order is governed by a combination of the account ID and the token ID values, with account ID being the parent column. The token ID value governs its order within the given account ID.

Note: The default order for this API is currently ascending. The account ID can be the owner or the spender ID depending upon the owner flag.

Filtering

When filtering there are some restrictions enforced to ensure correctness and scalability.

The table below defines the restrictions and support for the endpoint

Query Param	Comparison Operator	Support	Description	Example
account.id	eq	Y	Single occurrence only.	?account.id=X
	ne	N
	lt(e)	Y	Single occurrence only.	?account.id=lte:X
	gt(e)	Y	Single occurrence only.	?account.id=gte:X
token.id	eq	Y	Single occurrence only. Requires the presence of an account.id parameter	?account.id=X&token.id=eq:Y
	ne	N
	lt(e)	Y	Single occurrence only. Requires the presence of an lte or eq account.id parameter	?account.id=lte:X&token.id=lt:Y
	gt(e)	Y	Single occurrence only. Requires the presence of an gte or eq account.id parameter	?account.id=gte:X&token.id=gt:Y

Both filters must be a single occurrence of gt(e) or lt(e) which provide a lower and or upper boundary for search.

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

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

account.idEntityIdQuery (string)

The ID of the account to return information for

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

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}$

ownerboolean

Example: true

Response

Body

allowancesNftAllowances (array of NftAllowance (object))

approved_for_all*boolean

A boolean value indicating if the spender has the allowance to spend all NFTs owned by the given owner

Example: true

owner*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}$

spender*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}$

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