Skip to main content

/api/v1/schedules REST API Endpoint

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

Updated on
Aug 23, 2024

/api/v1/schedules REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Query Parameters

account.id
string
The ID of the account to return information for
limit
integer
The maximum number of items to return
order
string
The order in which items are listed
schedule.id
string
The ID of the schedule to return information for

Returns

schedules
array
An array of objects, each representing a scheduled transaction
admin_key
object
The admin_key object which contains the following fields:
_type
string
The type of the key
key
string
The key itself
deleted
boolean
A boolean indicating whether the schedule has been deleted
consensus_timestamp
string
The consensus timestamp when the schedule was created
creator_account_id
string
The account ID of the creator of the schedule
executed_timestamp
string
The timestamp when the scheduled transaction was executed
expiration_time
string
The expiration time of the schedule
memo
string
A memo associated with the schedule
payer_account_id
string
The account ID of the payer for the scheduled transaction
schedule_id
string
The unique identifier of the schedule
signatures
array
An array of objects, each representing a signature collected for the schedule
consensus_timestamp
string
The consensus timestamp when the signature was collected
public_key_prefix
string
The prefix of the public key that signed the transaction
signature
string
The signature itself
type
string
The type of the signature
transaction_body
string
The body of the transaction being scheduled, encoded in Base64
wait_for_expiry
boolean
A boolean indicating whether to wait for the schedule to expire if it has not yet been executed
links
object
An object containing pagination links
next
string
A URL to fetch the next set of transactions, if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/schedules'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free