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

# Get fungible token allowances for an account

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

Returns information for fungible token allowances for an account.

## Ordering
The order is governed by a combination of the spender id and the token id values, with spender id being the parent column.
The token id value governs its order within the given spender id.

Note: The default order for this API is currently ASC

## 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 |
| ------------- | ------------------- | ------- | --------------------- | ------- |
| spender.id    | eq                  | Y       | Single occurrence only. | ?spender.id=X |
|               | ne                  | N       | | |
|               | lt(e)               | Y       | Single occurrence only. | ?spender.id=lte:X |
|               | gt(e)               | Y       | Single occurrence only. | ?spender.id=gte:X |
| token.id      | eq                  | Y       | Single occurrence only. Requires the presence of a **spender.id** query | ?token.id=lt:Y |
|               | ne                  | N       | | |
|               | lt(e)               | Y       | Single occurrence only. Requires the presence of an **lte** or **eq** **spender.id** query | ?spender.id=lte:X&token.id=lt:Y |
|               | gt(e)               | Y       | Single occurrence only. Requires the presence of an **gte** or **eq** **spender.id** query | ?spender.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'
- `spender.id` string
- `token.id` string

## Response `200`

OK

- TokenAllowancesResponse
  - `allowances` TokenAllowance[]
    - `amount` integer — The amount remaining of the original amount granted.
    - `amount_granted` integer — The granted amount of the spender's allowance.
    - `owner` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `spender` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `timestamp` TimestampRange — 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 — 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)