# Generated by Scrape::ApiDefinitionsJob: 2018-09-25 01:15:43 UTC
# See: https://git.io/vx5CY
---
- name: :block_api
  description: 'Used to query values related to the block plugin. **These AppBase
    API methods are still under development and subject to change.**

'
  methods:
  - api_method: block_api.get_block
    purpose: |
      Retrieve a full, signed block of the referenced block, or null if no matching block was found.

      **Parameters:**

        * `block_num:int`

      | `block_num` (int) | |
      |-------------------|-|
      | `1` | Queries the very first block. |
      | `8675309` | Queries block number 8,675,309. |
      | `62396745` | Queries block number 62,396,745. |
    parameter_json: '{"block_num":0}'
    expected_response_json: "{}"
    curl_examples:
    - '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":1},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":8675309},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":62396745},
      "id":1}'
  - api_method: block_api.get_block_header
    purpose: "Retrieve a block header of the referenced block, or null if no matching
      block was found.\n\n**Parameters:**\n  \n  * `block_num:int` - Height of the
      block whose header should be returned\n\n| `block_num` (int) | |\n|-------------------|-|\n|
      `1` | Queries the block headers for the very first block. |\n| `8675309` | Queries
      block headers for block number 8,675,309. |\n| `62396745` | Queries block headers
      for block number 62,396,745. |\n"
    parameter_json: '{"block_num":0}'
    expected_response_json: "{}"
    curl_examples:
    - '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":1},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":8675309},
      "id":1}'
    - '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":62396745},
      "id":1}'
