---
title: "List hooks for an account"
method: GET
path: "/api/v1/accounts/{idOrAliasOrEvmAddress}/hooks"
tags: ["accounts"]
---

# List hooks for an account

`GET /api/v1/accounts/{idOrAliasOrEvmAddress}/hooks`

Returns a list of hooks associated with a given account ID, alias, or EVM address.

## Path parameters

- `idOrAliasOrEvmAddress` string, required

## Query parameters

- `hook.id` integer
- `limit` integer
- `order` 'asc' | 'desc'

## Response `200`

OK

- HooksResponse
  - `hooks` Hook[], required
    - `admin_key` Key, nullable, required — The public key which controls access to various network entities.
      - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
      - `key` string
    - `contract_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `created_timestamp` string, nullable, required — A Unix timestamp in seconds.nanoseconds format
    - `deleted` boolean, required — Whether the hook has been deleted
    - `extension_point` 'ACCOUNT_ALLOWANCE_HOOK', required — The extension point this hook implements
    - `hook_id` integer, required — The unique identifier for the hook within the owner's scope
    - `owner_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `timestamp_range` TimestampRangeNullable, nullable, 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
    - `type` 'EVM', required — The type of the hook implementation
  - `links` Links, required
    - `next` string, nullable

## Other responses

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

## Changes

- **2026-01-22** (v1) `e44cfc649d5f` — 1 warning, 1 info
  - added the new `EVM` enum value to the `hooks/items/type` response property for the response status `200`
  - removed the `LAMBDA` enum value from the `hooks/items/type` response property for the response status `200`
- **2025-11-04** (v1) `4a9a4e5f3bda` — 1 info
  - endpoint added
- **2025-08-08** (v1) `db389f03b097` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/changes/api/v1/accounts/:idOrAliasOrEvmAddress/hooks/get.md)

---

[API](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiero-ledger/apis/mirror-node-rest-api/revisions/b3d1ffa9701e?raw)