API specification

Access restrictions

The API endpoints are by default restricted to a whitelist of IPs that can be found in the config.json in the following section, api.access.whitelist. If you wish to have your API accessible to the public, this can be achieved by changing api.access.public to true. This will allow anyone to make requests to your Lisk Core node. However some endpoints stay private, hence only a list of whitelisted IPs can successfully make API calls to that particular endpoint; this includes all forging related API calls. By default, only the node’s local IP address is included in the whitelist. It is possible to change the setting in the config.json in the following section, forging.access.whitelist. For more details, see the descriptions at the respective endpoint.

Requests

Chained filter parameters are logically connected with AND. HTTP is the supported URL schema by default. To enable HTTPS, please adjust the ssl section in config.json.

Responses

The general response format is JSON (application/json). The responses for each API request have a common basic structure:

{
    "data": {}, //Contains the requested data
    "meta": {}, //Contains additional metadata, e.g. the values of `limit` and `offset`
    "links": {} //Will contain links to connected API calls from here, e.g. pagination links
}

Date formats

Most of the timestamp parameters are in the Lisk Timestamp format, which is similar to the Unix Timestamp format. The Lisk Timestamp is the number of seconds that have elapsed since the Lisk epoch time (2016-05-24T17:00:00.000Z), not counting leap seconds. The Lisk Epoch Time is returned in the ISO8601 format, combined date and time: YYYY-MM-DDThh:mm:ssZ. For more details, see the descriptions and examples at the respective endpoint.

Pagination

It is possible to paginate nicely through the results by providing limit and offset parameters to the requests. limit and offset can be found in the meta-object of the response of an API request. If no limit and offset are provided, they are set to 10 and 0 by default, which will be displayed in the first 10 results.

List of endpoints

All possible API endpoints for Lisk Core are listed below. Click on an endpoint to show descriptions, details and examples.

Version information

Version : 1.0.32

Contact information

Contact Email : admin@lisk.io

License information

License : Apache 2.0
License URL : http://www.apache.org/licenses/LICENSE-2.0
Terms of service : null

URI scheme

BasePath : /api
Schemes : HTTP, HTTPS

Tags

  • Accounts : Account related API calls

  • Blocks : Block related API calls

  • Dapps : Dapps related API calls

  • Delegates : Delegates related API calls

  • Node : Node related API calls

  • Peers : Peers related API Calls

  • Signatures : Signatures related API calls

  • Transactions : Transactions related API calls

  • Voters : Votes related API calls

  • Votes : Votes related API calls

Paths

Requests account data

GET /accounts

Description

Search for matching accounts in the system.

Parameters

Type Name Description Schema Default

Query

address
optional

Address of an account

string (address)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

publicKey
optional

Public key to query

string (publicKey)

Query

secondPublicKey
optional

Second public key to query

string (publicKey)

Query

sort
optional

Fields to sort results by

enum (balance:asc, balance:desc)

"balance:asc"

Query

username
optional

Delegate username to query

string (username)

Responses

HTTP Code Description Schema

200

List of accounts

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Accounts

Requests multisignature groups data

GET /accounts/{address}/multisignature_groups

Description

Searches for the specified account in the system, and responds with a list of the multisignature groups that this account is a member of.

Parameters

Type Name Description Schema

Path

address
required

Lisk address of an account

string (address)

Responses

HTTP Code Description Schema

200

List of multisignature accounts

400

Malformed query or parameters

404

Multisignature account not found

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Accounts

Requests multisignature membership data

GET /accounts/{address}/multisignature_memberships

Description

Searches for the specified multisignature group, and responds with a list of all members of this particular multisignature group.

Parameters

Type Name Description Schema

Path

address
required

Lisk address of a multisignature account

string (address)

Responses

HTTP Code Description Schema

200

List of multisignature accounts

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Accounts

Requests blocks data

GET /blocks

Description

Search for a specified block in the system.

Parameters

Type Name Description Schema Default

Query

blockId
optional

Block id to query

string (id)

Query

fromTimestamp
optional

Starting unix timestamp

integer

Query

generatorPublicKey
optional

Public key of the forger of the block

string (publicKey)

Query

height
optional

Current height of the network

integer (int32)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

sort
optional

Fields to sort results by

enum (height:asc, height:desc, totalAmount:asc, totalAmount:desc, totalFee:asc, totalFee:desc, timestamp:asc, timestamp:desc)

"height:desc"

Query

toTimestamp
optional

Ending unix timestamp

integer

Responses

HTTP Code Description Schema

200

Search results matching criteria

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Blocks

Requests dapps data

GET /dapps

Description

Search for a specified dapp in the system.

Parameters

Type Name Description Schema Default

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

name
optional

Name to query - Fuzzy search

string

Query

offset
optional

Offset value for results

integer (int32)

0

Query

sort
optional

Fields to sort results by

enum (name:asc, name:desc)

"name:asc"

Query

transactionId
optional

Dapp registration transaction ID

string (id)

Responses

HTTP Code Description Schema

200

Search results matching criteria

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Dapps

Requests delegates data

GET /delegates

Description

Search for a specified delegate in the system.

Parameters

Type Name Description Schema Default

Query

address
optional

Address of an account

string (address)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

publicKey
optional

Public key to query

string (publicKey)

Query

search
optional

Fuzzy delegate username to query

string

Query

secondPublicKey
optional

Second public key to query

string (publicKey)

Query

sort
optional

Fields to sort results by

enum (username:asc, username:desc, rank:asc, rank:desc, productivity:asc, productivity:desc, missedBlocks:asc, missedBlocks:desc, producedBlocks:asc, producedBlocks:desc)

"rank:asc"

Query

username
optional

Delegate username to query

string (username)

Responses

HTTP Code Description Schema

200

Search results matching criteria

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Delegates

Requests next forgers data

GET /delegates/forgers

Description

Returns a list of the next forgers in this delegate round.

Parameters

Type Name Description Schema Default

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Responses

HTTP Code Description Schema

200

Search results matching criteria

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Delegates

Requests forging stats by delegate

GET /delegates/{address}/forging_statistics

Description

By passing an existing delegate address and the desired unix timestamps, it is possible to acquire the forging statistics within the specified timespan. If no timestamps are provided, it will use the timestamps from Lisk epoch to current date.

Parameters

Type Name Description Schema

Path

address
required

Lisk address of a delegate

string (address)

Query

fromTimestamp
optional

Starting unix timestamp

integer

Query

toTimestamp
optional

Ending unix timestamp

integer

Responses

HTTP Code Description Schema

200

Results matching specified delegate address

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Delegates

Requests constants data

GET /node/constants

Description

Returns all current constants data on the system, e.g. Lisk epoch time and version.

Responses

HTTP Code Description Schema

200

Node constants response

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Node

Requests status data

GET /node/status

Description

Returns all current status data of the node, e.g. height and broadhash.

Responses

HTTP Code Description Schema

200

Node status response

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Node

Requests forging status of a delegate

GET /node/status/forging

Description

Attention! This is a private endpoint only authorized to whitelisted IPs. To edit the whitelist, please edit the forging.access.whitelist section in `config.json`<br> Responds with the forging status of a delegate on a node.

Parameters

Type Name Description Schema

Query

publicKey
optional

Public key to query

string (publicKey)

Responses

HTTP Code Description Schema

200

Search results matching criteria

400

Malformed query or parameters

403

Access denied

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Node

Toggles the forging status of a delegate

PUT /node/status/forging

Description

Attention! This is a private endpoint only authorized to whitelisted IPs. To edit the whitelist, please edit the forging.access.whitelist section in `config.json`<br> Upon passing the correct password and publicKey, forging will be enabled or disabled for the delegate of this particular node. The password can be generated locally by encrypting your passphrase, either by using Lisk Commander or with Lisk Elements.

Parameters

Type Name Description Schema

Body

data
required

Password for decrypting passphrase of delegate with corresponding public key

data

Name Description Schema

forging
required

Forging status of the delegate
Example : true

boolean

password
required

Password for decrypting passphrase of delegate.
Minimum length : 5
Example : "happy tree friends"

string

publicKey
required

Public key of the delegate.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

Responses

HTTP Code Description Schema

200

Delegate forging toggled on or off

400

Malformed query or parameters

403

Access denied

404

Provided public key not found

429

Too many requests, exceeded rate limit

500

Unexpected error

Consumes

  • application/json

Produces

  • application/json

Tags

  • Node

Requests unprocessed transactions data

GET /node/transactions/{state}

Description

By specifying the state of the transactions, it is possible to view a list of unprocessed transactions matching this state. Search for specific transactions by providing the appropriate parameters. If a batch of transactions is posted, they will appear in the unprocessed list after a small delay, depending on the server load.

Parameters

Type Name Description Schema Default

Path

state
required

State of transactions to query

enum (pending, ready, received, validated, verified)

"verified"

Query

id
optional

Transaction id to query

string (id)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

recipientId
optional

Recipient lisk address

string (address)

Query

recipientPublicKey
optional

Recipient public key

string (publicKey)

Query

senderId
optional

Sender lisk address

string (address)

Query

senderPublicKey
optional

Sender public key

string (publicKey)

Query

sort
optional

Fields to sort results by

enum (amount:asc, amount:desc, fee:asc, fee:desc, type:asc, type:desc, timestamp:asc, timestamp:desc)

"amount:desc"

Query

type
optional

Transaction type (0-*)

integer

Responses

HTTP Code Description Schema

200

Transactions list

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Node

Requests peers data

GET /peers

Description

Search for specified peers.

Parameters

Type Name Description Schema Default

Query

broadhash
optional

Broadhash of the network

string (hex)

Query

height
optional

Current height of the network

integer (int32)

Query

httpPort
optional

Http port of the node or delegate

integer (int32)

Query

ip
optional

IP of the node or delegate

string (ip)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

os
optional

OS of the node

string

Query

protocolVersion
optional

Protocol version of the node

string (protocolVersion)

Query

sort
optional

Fields to sort results by

enum (height:asc, height:desc, version:asc, version:desc)

"height:desc"

Query

state
optional

Current state of the network

integer (int32)

Query

version
optional

Lisk version of the node

string (version)

Query

wsPort
optional

Web socket port for the node or delegate

integer (int32)

Responses

HTTP Code Description Schema

200

List of peers

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Peers

Submits a signature object to sign multisignature transactions

POST /signatures

Description

Submits signature to sign a multisignature transaction. Signature objects can be generated locally either by using Lisk Commander or with Lisk Elements.

Parameters

Type Name Description Schema

Body

signature
required

Signature object to submit to the network

Responses

HTTP Code Description Schema

200

Signature is accepted by the node for processing

400

Malformed query or parameters

409

Some error related to processing of request

429

Too many requests, exceeded rate limit

500

Unexpected error

Consumes

  • application/json

Produces

  • application/json

Tags

  • Signatures

Submits signed transaction for processing

POST /transactions

Description

Submits signed transaction object for processing by the transaction pool. Transaction objects can be generated locally either by using Lisk Commander or with Lisk Elements.

Parameters

Type Name Description Schema

Body

transaction
required

Transaction object to submit to the network

Responses

HTTP Code Description Schema

200

Transaction accepted by the node for processing

400

Malformed query or parameters

409

Some error related to processing of request

429

Too many requests, exceeded rate limit

Consumes

  • application/json

Produces

  • application/json

Tags

  • Transactions

Requests transactions data

GET /transactions

Description

Search for a specified transaction in the system.

Parameters

Type Name Description Schema Default

Query

blockId
optional

Block id to query

string (id)

Query

data
optional

Fuzzy additional data field to query

string (additionalData)

Query

fromTimestamp
optional

Starting unix timestamp

integer

Query

height
optional

Current height of the network

integer (int32)

Query

id
optional

Transaction id to query

string (id)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

maxAmount
optional

Maximum transaction amount in Beddows

integer

Query

minAmount
optional

Minimum transaction amount in Beddows

integer

Query

offset
optional

Offset value for results

integer (int32)

0

Query

recipientId
optional

Recipient lisk address

string (address)

Query

recipientPublicKey
optional

Recipient public key

string (publicKey)

Query

senderId
optional

Sender lisk address

string (address)

Query

senderIdOrRecipientId
optional

Lisk address

string (address)

Query

senderPublicKey
optional

Sender public key

string (publicKey)

Query

sort
optional

Fields to sort results by

enum (amount:asc, amount:desc, fee:asc, fee:desc, type:asc, type:desc, timestamp:asc, timestamp:desc)

"amount:asc"

Query

toTimestamp
optional

Ending unix timestamp

integer

Query

type
optional

Transaction type (0-*)

integer

Responses

HTTP Code Description Schema

200

Transactions list

400

Malformed query or parameters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Transactions

Requests voters data for a delegate

GET /voters

Description

Attention: At least *one of the filter parameters must be provided.* Returns all votes received by a delegate.

Parameters

Type Name Description Schema Default

Query

address
optional

Address of an account

string (address)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

publicKey
optional

Public key to query

string (publicKey)

Query

secondPublicKey
optional

Second public key to query

string (publicKey)

Query

sort
optional

Fields to sort results by

enum (publicKey:asc, publicKey:desc, balance:asc, balance:desc, username:asc, username:desc)

"publicKey:asc"

Query

username
optional

Delegate username to query

string (username)

Responses

HTTP Code Description Schema

200

Voters list

400

Malformed query or parameters

404

Requested resource not found based on provided filters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Voters

Requests votes data for an account

GET /votes

Description

Attention: At least *one of the filter parameters must be provided.* Returns all votes placed by an account.

Parameters

Type Name Description Schema Default

Query

address
optional

Address of an account

string (address)

Query

limit
optional

Limit applied to results

integer (int32)

10

Query

offset
optional

Offset value for results

integer (int32)

0

Query

publicKey
optional

Public key to query

string (publicKey)

Query

secondPublicKey
optional

Second public key to query

string (publicKey)

Query

sort
optional

Fields to sort results by

enum (username:asc, username:desc, balance:asc, balance:desc)

"username:asc"

Query

username
optional

Delegate username to query

string (username)

Responses

HTTP Code Description Schema

200

Votes list

400

Malformed query or parameters

404

Requested resource not found based on provided filters

429

Too many requests, exceeded rate limit

500

Unexpected error

Produces

  • application/json

Tags

  • Votes

Definitions

AccessDeniedError

Name Description Schema

message
required

Error message containing details of the error
Minimum length : 1

string

Account

Name Description Schema

address
required

The Lisk Address is the human readable representation of the accounts owners' public key. It consists of multiple numbers followed by a big 'L' at the end.
Example : "12668885769632475474L"

string (address)

publicKey
required

The public key is derived from the private key of the owner of the account. It can be used to validate that the private key belongs to the owner, but not provide access to the owner’s private key.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

secondPublicKey
optional

The second public key is derived from the second private key of an account, if the owner activated a second passphrase for her/his account.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

AccountExtended

Name Description Schema

address
required

The Lisk Address is the human readable representation of the accounts owners' public key. It consists of 21 numbers followed by a big 'L' at the end.
Example : "12668885769632475474L"

string (address)

asset
optional

Any JSON stored in the account’s asset field.
Example : { "custom" : true, "field" : true }

object

balance
required

The current balance of the account in Beddows.
Example : "1081560729258"

string

delegate
optional

publicKey
required

The public key is derived from the private key of the owner of the account. It can be used to validate that the private key belongs to the owner, but does not provide access to the owner’s private key.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

secondPublicKey
optional

The second public key is derived from the second private key of an account, if the owner activated a second passphrase for her/his account.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

AccountsResponse

Name Description Schema

data
required

List of accounts

< AccountExtended > array

links
required

object

meta
required

Block

Name Description Schema

blockSignature
optional

Derived from a SHA-256 hash of the block header, that is signed by the private key of the delegate who forged the block.
Example : "a3733254aad600fa787d6223002278c3400be5e8ed4763ae27f9a15b80e20c22ac9259dc926f4f4cabdf0e4f8cec49308fa8296d71c288f56b9d1e11dfe81e07"

string (signature)

confirmations
optional

Number of times that this Block has been confirmed by the network. By forging a new block on a chain, all former blocks in the chain get confirmed by the forging delegate.
Example : 200

integer

generatorAddress
optional

Lisk Address of the delegate who forged the block.
Example : "12668885769632475474L"

string (address)

generatorPublicKey
required

Public key of th edelagte who forged the block.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

height
required

Height of the network, when the block got forged. The height of the networks represents the number of blocks, that have been forged on the network since Genesis Block.
Minimum value : 1
Example : 123

integer

id
required

Unique identifier of the block. Derived from the block signature.
Length : 1 - 20
Example : "6258354802676165798"

string (id)

maxHeightPreviouslyForged
optional

Largest height of any block previously forged by the generatorPublicKey as defined in the Lisk BFT Protocol. See https://github.com/LiskHQ/lips/blob/master/proposals/lip-0014.md
Example : 123

integer

maxHeightPrevoted
optional

Largest height of an ancestor block with at least 68 prevotes as defined in the Lisk BFT Protocol. See https://github.com/LiskHQ/lips/blob/master/proposals/lip-0014.md
Example : 123

integer

numberOfTransactions
required

The number of transactions processed in the block.
Example : 15

integer

payloadHash
optional

Hash of the payload of the block. The payload of a block is comprised of the transactions the block contains. For each type of transaction exists a different maximum size for the payload.
Example : "4e4d91be041e09a2e54bb7dd38f1f2a02ee7432ec9f169ba63cd1f193a733dd2"

string (hex)

payloadLength
optional

Bytesize of the payload hash.
Minimum value : 0
Example : 117

integer

previousBlockId
optional

The id of the previous block of the chain.
Example : "15918760246746894806"

string (id)

reward
required

The Lisk reward for the delegate.
Example : "50000000"

string

timestamp
required

Unix Timestamp
Example : 28227090

integer

totalAmount
required

The total amount of Lisk transferred.
Example : "150000000"

string

totalFee
required

The total amount of fees associated with the block.
Example : "15000000"

string

totalForged
required

Total amount of LSK that have been forged in this Block. Consists of fees and the reward.
Example : "65000000"

string

version
optional

Versioning for future upgrades of the lisk protocol.
Minimum value : 0
Example : 0

integer

BlocksResponse

Blocks response

Name Schema

data
required

< Block > array

links
required

object

meta
required

Dapp

Name Description Schema

category
optional

The category of the Dapp.
Example : 8.0

number

description
optional

Description of the Dapp.
Example : "Smart Gun Network"

string

icon
optional

Dapp icon. A link to the icon can be provided in the Register Dapp Transaction object.
Example : "http://www.blocksafefoundation.com/header.jpg"

string

link
optional

Example : "https://github.com/blocksafe/SDK-notice/archive/master.zip"

string

name
required

Name of the Dapp.
Example : "Blocksafe"

string

tags
optional

Tags of the Dapp.
Example : "Smartgun"

string

transactionId
required

Unique Identifier of the Register Dapp Transaction. Derived from the transaction signature.
Length : 1 - 20
Example : "15359945250124697273"

string (id)

type
required

The type of the Dapp.
Example : 8.0

number

DappsResponse

Dapps endpoint response

Name Schema

data
required

< Dapp > array

links
required

object

meta
required

Delegate

Name Description Schema

approval
optional

Percentage of the voters weight, that the delegate owns in relation to the total supply of Lisk.
Example : 14.22

number

missedBlocks
optional

Total number of blocks the delegate has missed.
Example : 427

integer

producedBlocks
optional

Total number of blocks the delegate has forged.
Example : 20131

integer

productivity
optional

Productivity rate. Percentage of successfully forged blocks (not missed), by the delegate.
Example : 96.41

number

rewards
optional

Total sum of block rewards that the delegate has forged.
Example : "510000000"

string

username
required

The delegate’s username. A delegate chooses the username by registering a delegate on the Lisk network. It is unique and cannot be changed later.
Example : "isabella"

string (username)

voteWeight
required

The voters weight of the delegate. Represents the total amount of Lisk (in Beddows), that the delegates' voters own. The voters weight decides which rank the delegate gets in relation to the other delegates and their voters weights.
Example : "1081560729258"

string

DelegateWithAccount

Name Description Schema

account
required

approval
optional

Percentage of the voters weight, that the delegate owns in relation to the total supply of Lisk.
Example : 14.22

number

missedBlocks
optional

Total number of blocks the delegate has missed.
Example : 427

integer

producedBlocks
optional

Total number of blocks the delegate has forged.
Example : 20131

integer

productivity
optional

Productivity rate. Percentage of successfully forged blocks (not missed) by the delegate.
Example : 96.41

number

rewards
optional

Total sum of block rewards that the delegate has forged.
Example : "510000000"

string

username
required

The delegate’s username. A delegate chooses the username by registering a delegate on the Lisk network. It is unique and cannot be changed later.
Example : "isabella"

string (username)

voteWeight
required

The voters weight of the delegate. This represents the total amount of Lisk (in Beddows), that the delegates' voters own. The voters weight decides which rank the delegate gets in relation to the other delegates and their voters weights.
Example : "1081560729258"

string

DelegateWithVoters

Name Description Schema

address
required

The Lisk Address of a delegate.
Example : "12668885769632475474L"

string (address)

balance
required

Account balance. Amount of Lisk the delegate account owns.
Example : "1081560729258"

string

publicKey
optional

The public key of the delegate.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

username
required

The delegates' username. A delegate chooses the username by registering a delegate on the Lisk network. It is unique and cannot be changed later.
Example : "isabella"

string (username)

voters
required

List of accounts that voted for the queried delegate.

< Voter > array

votes
required

The voters weight of the delegate. Represents the total amount of Lisk (in Beddows) that the delegates' voters own. The voters weight decides which rank the delegate gets in relation to the other delegates and their voters weights.
Example : 108877

integer

DelegateWithVotes

Name Description Schema

address
required

The Lisk Address of the queried account.
Example : "12668885769632475474L"

string (address)

balance
required

The balance of the queried account.
Example : "1081560729258"

string

publicKey
optional

Public key of the queried account.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

username
required

Username of the account, if the queried account is a delegate
Example : "isabella"

string (username)

votes
required

List of placed votes by the queried account.

< Vote > array

votesAvailable
required

Number of votes that are available for the queried account. Derives from 101(max possible votes) - votesUsed(alreadu used votes)
Example : 40

integer

votesUsed
required

Number of votes that are already placed by the queried account.
Example : 2

integer

DelegatesResponse

Name Description Schema

data
required

List of delegates

links
required

object

meta
required

meta

Name Description Schema

limit
required

Default : 10
Minimum value : 1
Maximum value : 101

integer (int32)

offset
required

Fees

Name Description Schema

dappDeposit
required

Example : "10000000"

string

dappRegistration
required

Example : "2500000000"

string

dappWithdrawal
required

Example : "10000000"

string

delegate
required

Example : "2500000000"

string

multisignature
required

Example : "500000000"

string

secondSignature
required

Example : "500000000"

string

send
required

Example : "10000000"

string

vote
required

Example : "100000000"

string

Forger

Name Description Schema

address
required

The Lisk Address is the human readable representation of the accounts owners' public key. It consists of 21 numbers followed by a big 'L' at the end.
Example : "6251001604903637008L"

string (address)

nextSlot
required

Returns the slot number in which the forger will be able to forge the next block. Each slot has a timespan of 10 seconds. The first slot began directly after the Lisk Epoch Time.
Example : 4368793.0

number

publicKey
required

The public key is derived from the private key of the owner of the account. It can be used to validate that the private key belongs to the owner, but not provide access to the owners private key.
Example : "2ca9a7143fc721fdc540fef893b27e8d648d2288efa61e56264edf01a2c23079"

string (publicKey)

username
required

The delegates' username. A delegate chooses the username by registering a delegate on the Lisk network. It is unique and cannot be changed later.
Example : "isabella"

string (username)

ForgersResponse

Name Description Schema

data
required

List of forgers

< Forger > array

links
required

object

meta
required

meta

Name Description Schema

currentSlot
required

Currently active slot
Example : 10

integer

lastBlock
required

ID of the last processed block
Example : 10

integer

lastBlockSlot
required

Slot of the last processed block
Example : 10

integer

limit
required

Default : 10
Minimum value : 1
Maximum value : 101

integer (int32)

offset
required

ForgingStats

Name Description Schema

count
required

Amount of blocks, that the delegate has forged during the timespan.
Example : "100"

string

fees
required

Amount of fees, the delegate earned during the timespan.
Example : "15000000"

string

forged
required

Amount of Lisk, that have been transferred inside the forged blocks of a delegate, during the timespan.
Example : "65000000"

string

rewards
required

Amount of rewards, the delegate earned during the timespan.
Example : "50000000"

string

ForgingStatsResponse

Name Schema

data
required

links
required

object

meta
required

meta

Name Description Schema

fromTimestamp
required

Starting unix timestamp
Example : 0

integer

toTimestamp
required

Ending unix timestamp
Example : 1525861914

integer

ForgingStatus

Name Description Schema

forging
required

True if the delegate enabled forging.
Example : true

boolean

publicKey
required

Public key of the queried delegate.
Example : "2ca9a7143fc721fdc540fef893b27e8d648d2288efa61e56264edf01a2c23079"

string (publicKey)

ForgingStatusResponse

Name Schema

data
required

< ForgingStatus > array

links
required

object

meta
required

object

GeneralStatusResponse

Name Schema

data
required

links
required

object

meta
required

data

Name Description Schema

message
required

Minimum length : 1

string

meta

Name Description Schema

status
required

Acceptance status for transactions
Example : true

boolean

Limit

Limit applied to results

Type : integer (int32)

Meta

Name Schema

limit
required

offset
required

MultisignatureGroup

Name Description Schema

address
required

The Lisk Address is the human readable representation of the accounts owners' public key. It consists of 21 numbers followed by a big 'L' at the end.
Example : "12668885769632475474L"

string (address)

balance
required

The current balance of the account in Beddows.
Example : "1081560729258"

string

lifetime
required

The maximum amount of hours, that a transaction will wait for the minimum amount of signatures to be reached. If not enough members of a multisignature group sign the transaction in the defined lifespan, the transaction will be invalid.
Example : 72

integer

members
required

< Account > array

min
required

Minimum amount of signatures a transaction needs to be signed successfully by this multisignature account.
Example : 3

integer

publicKey
required

The public key is derived from the private key of the owner of the account. It can be used to validate that the private key belongs to the owner, but not provide access to the owners private key.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

secondPublicKey
optional

The second public key is derived from the second private key of an account, if the owner activated a second passphrase for her/his account.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

MultisignatureGroupsResponse

Name Description Schema

data
required

List of multisignature groups

links
required

object

meta
required

object

NodeConstants

Name Description Schema

build
required

The build number. Consists of v + the date and time of the build of the node.
Example : "v09:54:35 12/04/2017"

string

commit
required

The last commit that was added to the codebase.
Length : 40
Example : "7199d4b67c3575d5f99d1c29436a02977eeb01a7"

string

epoch
required

Timestamp of first block on the network.
Example : "2016-05-24T17:00:00.000Z"

string (date-time)

fees
required

milestone
required

The Reward, each forger will get for forging a block at the current slot. After a certain amount of slots, the reward will be reduced.
Example : "500000000"

string

networkId
required

Unique identifier for the network. The networkId that the node is connecting to, see LIP-0009 for more details.
Example : "ed14889723f24ecc54871d058d98ce91ff2f973192075c0155ba2b7b70ad2511"

string

protocolVersion
optional

The Lisk Core protocol version, that the node is running on.
Example : "1.0"

string (protocolVersion)

reward
required

The reward a delegate will get for forging a block. Depends on the slot height.
Example : "500000000"

string

supply
required

Total supply of LSK in the network.
Example : "10575384500000000"

string

version
required

The Lisk Core version, that the node is running on.
Example : "v0.8.0"

string (version)

NodeConstantsResponse

Name Schema

data
required

links
required

object

meta
required

object

NodeStatus

Name Description Schema

chainMaxHeightFinalized
required

The largest height with precommits by at least 68 delegates. See the following url: https://github.com/LiskHQ/lips/blob/master/proposals/lip-0014.md
Example : 123

integer

currentTime
required

Current time of the node in miliseconds, (Unix Timestamp).
Example : 1533558858128

integer

height
required

Current block height of the node. Represents the current number of blocks in the chain on the node.
Minimum value : 1
Example : 123

integer

secondsSinceEpoch
required

Number of seconds that have elapsed since the Lisk epoch time, (Lisk Timestamp).
Example : 1533558858

integer

syncing
required

True if the node syncing with other peers.
Example : false

boolean

NodeStatusResponse

Name Schema

data
required

links
required

object

meta
required

object

NotFoundError

Name Description Schema

message
required

Error message containing details of the error
Minimum length : 1

string

Offset

Offset value for results

Type : integer (int32)

ParamError

Collection of errors on a particular parameter

Name Description Schema

code
required

Valid error code explaining error
Example : "INVALID_REQUEST_PARAMETER"

string

errors
optional

Array of individual validation error for a particular param

< ParamErrorMessage > array

in
optional

Where the param was specified, e.g. path, query, form-data
Example : "query"

string

message
required

Detailed message explaining the error
Example : "Invalid parameter (offset) value failed JSON schema validation"

string

name
required

Parameter name for which error triggered
Example : "offset"

string

ParamErrorMessage

Singular error detail for a parameter

Name Description Schema

code
optional

Valid error code explaining error
Example : "MINIMUM"

string

description
optional

Param description specified in schema

string

message
required

Detailed message explaining error
Example : "Value -1 is less than minimum 0"

string

path
optional

The array/object paths which identify the param associated with the error

< string > array

ParamErrorResponse

Response generated in case of parameters validation

Name Description Schema

errors
required

Array of individual parameter errors

< ParamError > array

message
required

Message stating some valdiation error occurred
Example : "Validation errors"

string

Peer

Name Description Schema

height
optional

Network height on the peer node. Represents the current number of blocks in the chain on the peer node.
Example : 123

integer

httpPort
optional

The port the peer node uses for HTTP requests, e.g. API calls.
Minimum value : 1
Maximum value : 65535
Example : 8000

integer (int32)

ip
optional

IPv4 address of the peer node.
Example : "127.0.0.1"

string (ip)

networkId
optional

The network identifier as per LIP-0009
Example : "11a254dc30db5eb1ce4001acde35fd5a14d62584f886d30df161e4e883220eb7"

string

os
optional

The Operating System, that the peer node runs on.
Example : "debian"

string

protocolVersion
optional

The protocol version of Lisk Core that the peer node runs on.
Example : "1.0"

string (protocolVersion)

state
required

The state of the Peer.
Example : "connected"

enum (connected, disconnected)

version
optional

The version of Lisk Core that the peer node runs on.
Example : "v0.8.0"

string (version)

wsPort
required

The port the peer node uses for Websocket Connections, e.g. P2P broadcasts.
Minimum value : 1
Maximum value : 65535
Example : 8001

integer (int32)

PeersResponse

Peers response

Name Schema

data
required

< Peer > array

links
required

object

meta
required

meta

Name Description Schema

count
required

Number of peers in the response
Example : 100

integer

limit
required

offset
required

ProcessingError

Name Description Schema

code
optional

Error code containing details on status

integer

errors
optional

Array containing TransactionError objects

< TransactionError > array

message
required

Error message containing details of the error
Minimum length : 1

string

RequestLimitError

Name Description Schema

error
optional

Example : "Request limit exceeded. Please try again later"

string

Signature

Name Description Schema

publicKey
required

Public key of the account that intends to sign the multisignature transaction.
Example : "2ca9a7143fc721fdc540fef893b27e8d648d2288efa61e56264edf01a2c23079"

string (publicKey)

signature
required

Signature to sign the transaction. The signature can be generated locally, either by using Lisk Commander or with Lisk Elements.
Example : "2821d93a742c4edf5fd960efad41a4def7bf0fd0f7c09869aed524f6f52bf9c97a617095e2c712bd28b4279078a29509b339ac55187854006591aa759784c205"

string (signature)

transactionId
required

Unique identifier of the multisignature transaction to sign.
Length : 1 - 20
Example : "222675625422353767"

string (id)

SignatureResponse

Signature response

Name Schema

data
required

links
required

object

meta
required

data

Name Description Schema

message
required

Minimum length : 1

string

meta

Name Description Schema

status
required

Acceptance status for the signature
Example : true

boolean

Transaction

Name Description Schema

asset
required

object

blockId
optional

The Id of the block, this transaction is included in.
Length : 1 - 20
Example : "6258354802676165798"

string (id)

confirmations
optional

Number of times that this transaction has been confirmed by the network. By forging a new block on a chain, all former blocks and their contained transactions in the chain get confirmed by the forging delegate.
Minimum value : 0

integer

fee
required

Transaction fee associated with this transaction.
Example : "1000000"

string

height
optional

The height of the network, at the moment where this transaction was included in the blockchain.
Minimum value : 1

integer

id
required

Unique identifier of the transaction. Derived from the transaction signature.
Length : 1 - 20
Example : "222675625422353767"

string (id)

ready
optional

Only present in transactions sent from a multisignature account, or transactions type 4 (multisignature registration). False, if the minimum amount of signatures to sign this transaction has not been reached yet. True, if the minimum amount of signatures has been reached.
Example : false

boolean

receivedAt
optional

The timestamp of the moment, where a node discovered a transaction for the first time.

string (date-time)

senderId
optional

Lisk Address of the Senders' account.
Example : "12668885769632475474L"

string (address)

senderPublicKey
required

The public key of the Senders' account.
Example : "2ca9a7143fc721fdc540fef893b27e8d648d2288efa61e56264edf01a2c23079"

string (publicKey)

senderSecondPublicKey
optional

The second public key of the Senders' account, if it exists.
Example : "2ca9a7143fc721fdc540fef893b27e8d648d2288efa61e56264edf01a2c23079"

string (publicKey)

signSignature
optional

Contains the second signature, if the transaction is sent from an account with second passphrase activated.
Example : "2821d93a742c4edf5fd960efad41a4def7bf0fd0f7c09869aed524f6f52bf9c97a617095e2c712bd28b4279078a29509b339ac55187854006591aa759784c205"

string (signature)

signature
required

Derived from a SHA-256 hash of the transaction object, that is signed by the private key of the account who created the transaction.
Example : "2821d93a742c4edf5fd960efad41a4def7bf0fd0f7c09869aed524f6f52bf9c97a617095e2c712bd28b4279078a29509b339ac55187854006591aa759784c205"

string (signature)

signatures
optional

< string (signature) > array

timestamp
required

Time when the transaction was created. Unix Timestamp.
Example : 28227090

integer

type
required

Describes the Transaction type.
Minimum value : 0

integer

TransactionError

Name Description Schema

dataPath
required

Transaction field with error

string

id
required

Transaction ID
Minimum length : 1

string

message
required

Error message

string

name
optional

Type of Error

string

TransactionRequest

Name Description Schema

asset
required

Displays additional transaction data. Can include e.g. vote data or delegate username.

id
required

Unique identifier of the transaction. Derived from the transaction signature.
Length : 1 - 20
Example : "222675625422353767"

string (id)

senderPublicKey
required

The public key of the Senders' account.
Example : "2ca9a7143fc721fdc540fef893b27e8d648d2288efa61e56264edf01a2c23079"

string (publicKey)

signSignature
optional

Contains the second signature, if the transaction is sent from an account with second passphrase activated.
Example : "2821d93a742c4edf5fd960efad41a4def7bf0fd0f7c09869aed524f6f52bf9c97a617095e2c712bd28b4279078a29509b339ac55187854006591aa759784c205"

string (signature)

signature
required

Derived from a SHA-256 hash of the transaction object, that is signed by the private key of the account who created the transaction.
Example : "2821d93a742c4edf5fd960efad41a4def7bf0fd0f7c09869aed524f6f52bf9c97a617095e2c712bd28b4279078a29509b339ac55187854006591aa759784c205"

string (signature)

signatures
optional

If the transaction is a multisignature transaction, all signatures of the members of the corresponding multisignature group will be listed here.

< string (signature) > array

timestamp
required

Time when the transaction was created. Unix Timestamp.
Example : 28227090

integer

type
required

Describes the Transaction type.
Minimum value : 0

integer

asset

Name Description Schema

amount
optional

Amount of Lisk to be transferred in this transaction.
Example : "150000000"

string

recipientId
optional

Lisk Address of the Recipients' account.
Example : "12668885769632475474L"

string (address)

TransactionsResponse

Transactions response

Name Schema

data
required

< Transaction > array

links
required

object

meta
required

meta

Name Description Schema

count
required

Number of transactions in the response.
Example : 100

integer

limit
required

offset
required

UnexpectedError

Name Description Schema

message
required

Error message containing details of the error.
Minimum length : 1

string

Vote

Name Description Schema

address
required

Lisk Address of the delegate the queried account voted for.
Example : "12668885769632475474L"

string (address)

balance
required

Balance of the delegate the queried account voted for.
Example : "1081560729258"

string

publicKey
required

Public key of the delegate the queried account voted for.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

username
required

Username of the delegate the queried account voted for.
Example : "liskhq"

string (username)

Voter

Name Description Schema

address
required

The Lisk Address of the account that voted for the queried delegate.
Example : "12668885769632475474L"

string (address)

balance
required

Balance of the account that voted for the queried delegate.
Example : "1081560729258"

string

publicKey
required

Public key of the account that voted for the queried delegate.
Example : "968ba2fa993ea9dc27ed740da0daf49eddd740dbd7cb1cb4fc5db3a20baf341b"

string (publicKey)

VotersResponse

Voters endpoint response

Name Schema

data
required

links
required

object

meta
required

VotesResponse

Votes endpoint response

Name Schema

data
required

links
required

object

meta
required

meta

Name Description Schema

limit
required

Default : 10
Minimum value : 1
Maximum value : 101

integer (int32)

offset
required