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

# POST /EXPERIMENTAL_congestion_level

`POST /EXPERIMENTAL_congestion_level`

Queries the congestion level of a shard. More info about congestion [here](https://near.github.io/nearcore/architecture/how/receipt-congestion.html?highlight=congestion#receipt-congestion)

## Request body

- JsonRpcRequestForEXPERIMENTALCongestionLevel
  - `id` string — JSON-RPC request id. Auto-populated; can be any string.
  - `jsonrpc` '2.0' — JSON-RPC protocol version. Always `2.0`.
  - `method` 'EXPERIMENTAL_congestion_level', required
  - `params` union, required
    - object
      - `block_id` union, required
        - integer
        - string
      - `shard_id` integer, required — The shard identifier. It may be an arbitrary number - it does not need to be a number in the range 0..NUM_SHARDS. The shard ids do not need to be sequential or contiguous. The shard id is wrapped in a new type to prevent the old pattern of using indices in range 0..NUM_SHARDS and casting to ShardId. Once the transition if fully complete it potentially may be simplified to a regular type alias.
    - object
      - `chunk_id` string, required

## Response `200`

- union
  - object
    - `result` RpcCongestionLevelResponse, required
      - `congestion_level` number, double, required
    - `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` 'INVALID_SHARD_ID', required
          - object
            - `info` object, required
              - …
            - `name` 'UNKNOWN_CHUNK', 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-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/EXPERIMENTAL_congestion_level/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)