Getblock

getblock operations.

getblock

post

Returns information about the block with the given block hash. Optional verbosity levels determine the level of detail in the response:

• 0: Returns a string that is serialized, hex-encoded data for the block.

• 1: Returns a JSON object with basic block details and txids.

• 2: Returns a JSON object with detailed transaction info.

Authorizations

api-keyAuth

api-keystringRequired

NOWNodes API key passed in the api-key header.

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringRequired

JSON-RPC protocol version.

Example: 1.0

idstringRequired

Client-provided request identifier echoed in the response.

Example: curltest

methodstring · enumRequired

JSON-RPC method name.

Example: getblockPossible values:

Responses

200

Block information retrieved successfully

application/json

Object containing getblock response details.

errorone of · nullableRequired

JSON-RPC error object or null on success.

or

stringOptional

JSON-RPC error object. Null when the request succeeds.

Example: {"code":-28,"message":"Service temporarily unavailable"}

idone of · nullableRequired

Request id echoed by the server.

stringOptional

Client-provided request identifier echoed in the response.

Example: curltest

or

integerOptional

Client-provided request identifier echoed in the response.

Example: curltest

Other propertiesanyOptional

401

Unauthorized: API key is present but rejected by the NOWNodes gateway.

text/plain

405

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

text/plain

422

Missing API key. The NOWNodes gateway returns plain text for this error.

text/plain

500

Internal Server Error

application/json

post/

HTTPcURLJavaScriptPython

POST / HTTP/1.1
Host: btc-testnet.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblock",
  "params": []
}

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "tx": []
  },
  "error": null,
  "id": 1
}