---
title: "POST /next_light_client_block"
method: POST
path: "/next_light_client_block"
---

# POST /next_light_client_block

`POST /next_light_client_block`

Returns the next light client block.

## Request body

- JsonRpcRequestForNextLightClientBlock
  - `id` string — JSON-RPC request id. Auto-populated; can be any string.
  - `jsonrpc` '2.0' — JSON-RPC protocol version. Always `2.0`.
  - `method` 'next_light_client_block', required
  - `params` RpcLightClientNextBlockRequest, required
    - `last_block_hash` string, required

## Response `200`

- union
  - object
    - `result` RpcLightClientNextBlockResponse, required — A state for the current head of a light client. More info [here](https://nomicon.io/ChainSpec/LightClient).
      - `approvals_after_next` union[]
        - union
          - string
          - unknown
      - `inner_lite` BlockHeaderInnerLiteView — A part of a state for the current head of a light client. More info [here](https://nomicon.io/ChainSpec/LightClient).
        - `block_merkle_root` string, required
        - `chunk_execution_root` union — Merkle root over the block's certified chunk execution results. `None` for pre-spice headers.
          - string
          - unknown
        - `epoch_id` string, required
        - `height` integer, required
        - `next_bp_hash` string, required
        - `next_epoch_id` string, required
        - `outcome_root` string, required
        - `prev_state_root` string, required
        - `timestamp` integer, required — Legacy json number. Should not be used.
        - `timestamp_nanosec` string, required
      - `inner_rest_hash` string
      - `next_block_inner_hash` string
      - `next_bps` ValidatorStakeView[], nullable
        - `account_id` string, required — NEAR Account Identifier. This is a unique, syntactically valid, human-readable account identifier on the NEAR network. [See the crate-level docs for information about validation.](index.html#account-id-rules) Also see [Error kind precedence](AccountId#error-kind-precedence). ## Examples ``` use near_account_id::AccountId; let alice: AccountId = "alice.near".parse().unwrap(); assert!("ƒelicia.near".parse::<AccountId>().is_err()); // (ƒ is not f) ```
        - `public_key` string, required
        - `stake` string, required
        - `validator_stake_struct_version` 'V1', required
      - `prev_block_hash` string
    - `id` string, required
    - `jsonrpc` string, required
  - object
    - `error` union, required
      - object
        - `cause` union, required
          - object
            - `info` object, required
              - …
            - `name` 'METHOD_NOT_FOUND', required
          - object
            - `info` object, required
              - …
            - `name` 'PARSE_ERROR', required
        - `name` 'REQUEST_VALIDATION_ERROR', required
      - object
        - `cause` union, required
          - object
            - `info` object, required
              - …
            - `name` 'INTERNAL_ERROR', required
          - object
            - `info` object, required
            - `name` 'UNKNOWN_BLOCK', required
          - object
            - `info` object, required
              - …
            - `name` 'EPOCH_OUT_OF_BOUNDS', required
        - `name` 'HANDLER_ERROR', required
      - object
        - `cause` InternalError, required
          - `info` object, required
            - `error_message` string, required
          - `name` 'INTERNAL_ERROR', required
        - `name` 'INTERNAL_ERROR', required
    - `id` string, required
    - `jsonrpc` string, required

## Changes

- **2026-08-10** `f586f4853138` — 1 info
  - added the optional property `oneOf[subschema #1]/result/inner_lite/allOf[#/components/schemas/BlockHeaderInnerLiteView]/chunk_execution_root` to the response with the `200` status
- **2026-05-21** `e1982645f483` — 1 breaking, 1 info
  - added `subschema #1` to the response body `oneOf` list for the response status `200`
  - removed `#/components/schemas/JsonRpcResponse_for_RpcLightClientNextBlockResponse_and_RpcLightClientNextBlockError_variant0` from the response body `oneOf` list for the response status `200`
- **2026-05-07** `28449cf3a488` — 1 breaking, 5 info
  - request property `jsonrpc` was restricted to a list of enum values
  - the request property `id` became optional
  - the request property `jsonrpc` became optional
  - the `id` request property default value `dontcare` was added
  - …2 more

[Change history](https://skmtc.dev/near/apis/near-protocol-json-rpc-api/changes/next_light_client_block/post.md)

---

[API](https://skmtc.dev/near/apis/near-protocol-json-rpc-api.md) · [All operations](https://skmtc.dev/near/apis/near-protocol-json-rpc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/near/near-protocol-json-rpc-api/revisions/4a6c7147e1c3/schema)