---
title: "List schedules entities"
method: GET
path: "/api/v1/schedules"
tags: ["schedules"]
---

# List schedules entities

`GET /api/v1/schedules`

Lists schedules on the network that govern the execution logic of scheduled transactions. This includes executed and non executed schedules.

## Query parameters

- `account.id` string
- `limit` integer
- `order` 'asc' | 'desc'
- `schedule.id` string

## Response `200`

OK

- SchedulesResponse
  - `schedules` Schedule[]
    - `admin_key` Key, nullable — The public key which controls access to various network entities.
      - `_type` 'ECDSA_SECP256K1' | 'ED25519' | 'ProtobufEncoded'
      - `key` string
    - `consensus_timestamp` string — A Unix timestamp in seconds.nanoseconds format
    - `creator_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `deleted` boolean
    - `executed_timestamp` string, nullable — A Unix timestamp in seconds.nanoseconds format
    - `expiration_time` string, nullable — A Unix timestamp in seconds.nanoseconds format
    - `memo` string
    - `payer_account_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `schedule_id` string, nullable — Network entity ID in the format of `shard.realm.num`
    - `signatures` ScheduleSignature[]
      - `consensus_timestamp` string — A Unix timestamp in seconds.nanoseconds format
      - `public_key_prefix` string, byte
      - `signature` string, byte
      - `type` 'CONTRACT' | 'ED25519' | 'RSA_3072' | 'ECDSA_384' | 'ECDSA_SECP256K1' | 'UNKNOWN'
    - `transaction_body` string, byte
    - `wait_for_expiry` boolean
  - `links` Links
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter

---

[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)