--- title: "POST /get_block_header_state" method: POST path: "/get_block_header_state" --- # POST /get_block_header_state `POST /get_block_header_state` Retrieves the glock header state ## Request body - object - `block_num_or_id` string, required — Provide a block_number or a block_id ## Response `200` OK - BlockHeaderState - `id` string, required — ID of block - `block_num` integer, required — height of this block in the chain - `header` Block, required - `timestamp` string, required — Date/time string in the format YYYY-MM-DDTHH:MM:SS.sss - `producer` union, required - string - union - string — String representation of privileged EOSIO name type - string — String representation of basic EOSIO name type, must be 12 characters and contain only a-z and 0-5 - string — String representation of EOSIO bid name type, 1-12 characters and only a-z and 0-5 are allowed - string — String representation of EOSIO name type - `confirmed` integer, required — number of prior blocks confirmed by this block producer in current schedule - `previous` string, required - `transaction_mroot` string, required - `action_mroot` string, required - `schedule_version` integer, required — number of times producer schedule has changed since genesis - `new_producers` ProducerSchedule, required — A json object that encapsulates the list of producers schedule and its version. - `version` integer — The version of the producers schedule list. Version is an integer subsequently incremented. - `producers` object[] — The list of producers. - `producer_name` string — The name of the producer. - `authority` object[] — Array that has as first element the version of the authority json objects and then the objects themselves. - `threshold` integer — The threshold value for the producer's authority. - `keys` object[] — An array of producers keys definition. - `key` string — The public key associated with the producer. - `weight` integer — The weight of the key in the producer's authority. - `header_extensions` union[] - union - integer - string - `new_protocol_features` object[] — list of new protocol features - `producer_signature` string, required — Base58 encoded EOSIO cryptographic signature - `transactions` TransactionReceipt[] — list of valid transaction receipts included in block - `status` 'executed' | 'soft_fail' | 'hard_fail' | 'delayed' | 'expired', required — status: * `executed` - Succeed, no error handler executed * `soft_fail` - Objectively failed (not executed), error handler executed * `hard_fail` - Objectively failed and error handler objectively failed thus no state change * `delayed` - Used by delayed-user transactions for timer-based executions * `expired` - Transaction expired and storage space refunded to user - `cpu_usage_us` integer, required - `net_usage_words` integer, required - `trx` union, required - string - PackedTransaction - `id` string, required - `signatures` Signature[], required - `compression` string, required - `packed_context_free_data` string, required - `context_free_data` string[], required - `packed_trx` string, required - `transaction` Transaction, required - `expiration` string, required — Date/time string in the format YYYY-MM-DDTHH:MM:SS - `ref_block_num` integer, required - `ref_block_prefix` integer, required — 32-bit portion of block ID - `max_net_usage_words` union, required — A whole number - … - `max_cpu_usage_ms` union, required — A whole number - … - `delay_sec` integer, required - `context_free_actions` Action[], required - … - `actions` Action[], required - … - `transaction_extensions` Extension[] - … - `block_extensions` union[] - union - integer - string - `id` string - `block_num` integer — height of this block in the chain - `ref_block_prefix` integer — 32-bit portion of block ID - `dpos_proposed_irreversible_blocknum` union, required — A whole number - string - integer - `dpos_irreversible_blocknum` union, required — A whole number - string - integer - `bft_irreversible_blocknum` union, required — A whole number - string - integer - `pending_schedule_lib_num` union, required — A whole number - string - integer - `pending_schedule_hash` string, required - `pending_schedule` ProducerSchedule, required — A json object that encapsulates the list of producers schedule and its version. - `version` integer — The version of the producers schedule list. Version is an integer subsequently incremented. - `producers` object[] — The list of producers. - `producer_name` string — The name of the producer. - `authority` object[] — Array that has as first element the version of the authority json objects and then the objects themselves. - `threshold` integer — The threshold value for the producer's authority. - `keys` object[] — An array of producers keys definition. - `key` string — The public key associated with the producer. - `weight` integer — The weight of the key in the producer's authority. - `active_schedule` ProducerSchedule, required — A json object that encapsulates the list of producers schedule and its version. - `version` integer — The version of the producers schedule list. Version is an integer subsequently incremented. - `producers` object[] — The list of producers. - `producer_name` string — The name of the producer. - `authority` object[] — Array that has as first element the version of the authority json objects and then the objects themselves. - `threshold` integer — The threshold value for the producer's authority. - `keys` object[] — An array of producers keys definition. - `key` string — The public key associated with the producer. - `weight` integer — The weight of the key in the producer's authority. - `blockroot_merkle` BlockrootMerkle, required - `_active_nodes` Sha256[], required - `_node_count` union, required — A whole number - string - integer - `producer_to_last_produced` array[], required - union[] - union - union - string — String representation of privileged EOSIO name type - string — String representation of basic EOSIO name type, must be 12 characters and contain only a-z and 0-5 - string — String representation of EOSIO bid name type, 1-12 characters and only a-z and 0-5 are allowed - string — String representation of EOSIO name type - union — A whole number - string - integer - `producer_to_last_implied_irb` array[], required - union[] - union - union - string — String representation of privileged EOSIO name type - string — String representation of basic EOSIO name type, must be 12 characters and contain only a-z and 0-5 - string — String representation of EOSIO bid name type, 1-12 characters and only a-z and 0-5 are allowed - string — String representation of EOSIO name type - union — A whole number - string - integer - `block_signing_key` string, required — Base58 encoded EOSIO public key - `confirm_count` WholeNumber[], required - union — A whole number - string - integer - `confirmations` unknown[], required - unknown --- [API](https://skmtc.net/worldwide-asset-exchange/apis/chain-api.md) · [All operations](https://skmtc.net/worldwide-asset-exchange/apis/chain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worldwide-asset-exchange/chain-api/versions/5bfa22186461/schema)