---
title: "Get non fungible token allowances for an account"
method: GET
path: "/api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/nfts"
tags: ["accounts"]
---

# Get non fungible token allowances for an account

`GET /api/v1/accounts/{idOrAliasOrEvmAddress}/allowances/nfts`

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.

## Path parameters

- `idOrAliasOrEvmAddress` string, required

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `account.id` string
- `token.id` string
- `owner` boolean

## Response `200`

OK

- NftAllowancesResponse
  - `allowances` NftAllowance[]
    - `approved_for_all` boolean, required — A boolean value indicating if the spender has the allowance to spend all NFTs owned by the given owner
    - `owner` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `spender` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `timestamp` TimestampRange, required — A timestamp range an entity is valid for
      - `from` string — The inclusive from timestamp in seconds
      - `to` string, nullable — The exclusive to timestamp in seconds
    - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
  - `links` Links
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter
- `404` — Not Found

---

[API](https://skmtc.dev/hedera/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hedera/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedera/mirror-node-rest-api/revisions/45f5ccac560c/schema)