Gets list of the blocks using filtration; by definite blocks `from block to block`, by time `from time to time`, signed, with unspent coins, etc.
## Request Structure
`JSON object:`
```JSON
{
"method": "block",
"subcommand": ["list"],
"arguments": {
"net": "network_name",
"chain": "chain_name",
"signed | first_signed": "null",
"from_hash": "block_hash",
"to_hash": "block_hash",
"from_date": "YYMMDD",
"to_date": "YYMMDD",
"cert | pkey_hash": "signing_cert_name | signing_cert_pkey_hash",
"unspent": "null"
},
"id": "1"
}
```
`Parameters:`
**`net`** - name of the Cellframe Network. The list of networks can be found in the `<Config_dir> \ etc \ network` folder or received using - [[Node Command - NET LIST]]
**`chain`** - the name of chain (`main` or `zerochain`)
**`[{signed | first_signed}]`** - list of blocks, which were signed by the *master node*, and this signature is not necessarily on the first place / list of blocks, which were signed by the *master node* first `optional`
**`[from_hash <block_hash>][to_hash <block_hash>]`** - list filtration from definite block to block `optional`
**`[from_date <YYMMDD>][to_date <YYMMDD>]`** - block list filtration by date from time to time in the RCF822 format `optional`
**`[{cert <signing_cert_name> | pkey_hash <signing_cert_pkey_hash>}]`** - filtration by certificate or public key which was used to sign block `optional`
**`[unspent]`** - shows information only about blocks with unspent coins `optional`
If you make a request in the Cellframe network, use parameter `chain:main`.
### Curl Example
Let's see blocks from the date "250415" with unspent coins.
`Request:`
```actionscript
curl --unix-socket /opt/cellframe-node/var/run/node_cli -X POST http://localhost/connect -d '
{
"method": "block",
"subcommand": ["list"],
"arguments": {
"net": "riemann",
"chain": "main",
"from_date": "250415",
"unspent": "null"
},
"id": "1"
}'
```
`Response:`
```json
{
"type": 2,
"result": [
[
{
"block number": 17737,
"hash": "0xA074C476141D2F04332762E9EA653F8FA2071687BBEB359AC745DC7E4E1660F9",
"ts_create": "Tue, 15 Apr 2025 09:41:20 +0000"
},
{
"block number": 17736,
"hash": "0xC5F7159E6BACF736B56E1D4D62B4D663DC0AE7E6A4926B9069352975151743D0",
"ts_create": "Tue, 15 Apr 2025 08:11:51 +0000"
},
{
"block number": 17735,
"hash": "0x15ABBE1CA3304CB70784D99A31D18A148495BA42E5162E3B5DED96CB5E4C1748",
"ts_create": "Tue, 15 Apr 2025 08:07:36 +0000"
},
{
"block number": 17734,
"hash": "0x886DD61FB2FDD661B84E59164AE61C792CA5CB4035F1E49A6336A6EB54013EAA",
"ts_create": "Tue, 15 Apr 2025 08:06:51 +0000"
},
{
"block number": 17733,
"hash": "0x75966EAE5386B0C0FB7EEDC0FB52273DD15F2495DC0E33204DAABB16BBC38DFB",
"ts_create": "Tue, 15 Apr 2025 08:04:54 +0000"
},
{
"block number": 17732,
"hash": "0x09462848068425CAAC7405D4CF9DB51612B3A856D903B776FE9F9D4E9A5BD6C9",
"ts_create": "Tue, 15 Apr 2025 08:00:19 +0000"
},
{
"block number": 17731,
"hash": "0xBF3A2F7A318DF3F8A07D807BBBFC1916529701A484A5E4C33FA9C91EC4DA23BB",
"ts_create": "Tue, 15 Apr 2025 07:52:51 +0000"
},
{
"block number": 17730,
"hash": "0x58BFD6067AD0DAA264098D7622FC8B5E98C69754EA26C37B845DF874AC9D9515",
"ts_create": "Tue, 15 Apr 2025 07:47:10 +0000"
},
{
"limit": "unlimit"
}
],
{
"riemann.main with filter - filtered according to the specified criteria, have blocks": 8
}
],
"id": 1
}
```