How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kusama blocks API

The blocks API from Kusama — 8 operation(s) for blocks.

Kusama blocks API is one of 21 APIs that Kusama publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Blocks. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 8 operations across 8 paths, and defines 24 schemas. It is described by OpenAPI 3.2.0, at version 20.14.1.

Requests are made against 5 base URLs: https://polkadot-public-sidecar.parity-chains.parity.io/, https://kusama-public-sidecar.parity-chains.parity.io/, https://polkadot-asset-hub-public-sidecar.parity-chains.parity.io/, https://kusama-asset-hub-public-sidecar.parity-chains.parity.io/, http://localhost:8080.

8 operations 8 paths 24 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
20.14.1
Base URL
https://kusama-rpc.polkadot.io/
Resource Areas
1

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

blocks 8
GET
/blocks
Get a range of blocks by their height.
getBlock 7 params → 200400
GET
/blocks/{blockId}
Get a block by its height or hash.
getBlockById 10 params → 200400
GET
/blocks/{blockId}/header
Get a block's header by its height or hash.
getBlockHeaderById 3 params → 200400
GET
/blocks/{blockId}/extrinsics/{extrinsicIndex}
Get an extrinsic by its extrinsicIndex and block height or hash. The pair blockId, extrinsicIndex is sometimes referred to as a Timepoint.
getExtrinsicByTimepoint 8 params → 200400
GET
/blocks/head
Get the most recently finalized block.
getHeadBlock 9 params → 200
GET
/blocks/head/header
Get information about the header of the most recent finalized block.
getLatestBlockHeader 3 params → 200400
GET
/blocks/{blockId}/extrinsics-raw
Get a blocks header & its extrinsics as hex values.
getBlockRawExtrinsics 3 params → 200400
GET
/blocks/{blockId}/para-inclusions
Get all parachain inclusion information for a relay chain block.
getBlockParaInclusions 2 params → 200400

Schemas 24

The contract defines 24 schemas that model the data the API accepts and returns. The most detailed are Block (14 properties), Extrinsic (11 properties), BlockRaw (9 properties), BlockHeader (8 properties). Each schema is shown below with its type and property counts.

SanitizedEvent
object
2 properties
ParaInclusion
object
Information about a single parachain inclusion event
7 properties
DecodedXcmMsgsHorizontalMessagesInRelay
array
WeightsV2
object
2 properties
BlockFinalize
object
Object with an array of SanitizedEvents that occurred during block construction finalization with the method and data for each.
1 property
ExtrinsicMethod
object
Extrinsic method
2 properties
BlockRaw
object
9 properties
BlockInitialize
object
Object with an array of SanitizedEvents that occurred during block initialization with the method and data for each.
1 property
BlockWithDecodedXcmMsgs
Block information that includes the decoded XCM messages if any are found in the queried block. If not, the decodedXcmMsgs object will be returned with three e…
BlockHeader
object
8 properties
Block
object
Note: Block finalization does not correspond to consensus, i.e. whether the block is in the canonical chain. It denotes the finalization of block construction.
14 properties
ParaInclusionDescriptor
object
Candidate descriptor containing parachain inclusion metadata
6 properties
Signature
object
Object with signature and signer, or null if unsigned.
2 properties
ExtrinsicIndex
object
A single extrinsic at a given block.
5 properties
Extrinsic
object
11 properties
Blocks
array
DecodedXcmMsgsHorizontalMessagesInParachain
array
RuntimeDispatchInfo
object
RuntimeDispatchInfo for the transaction. Includes the partialFee.
4 properties
GenericExtrinsicEra
object
The return value for era can either be mortalEra, or immortalEra and is represented as an enum in substrate. immortalEra meaning the transaction is valid forev…
2 properties
Error
object
4 properties
DecodedXcmMsgs
object
Object with three arrays, one for every XCM direction. The arrays are populated or left empty based on the direction of the current XCM message that is being d…
1 property
DigestItem
object
3 properties
BlockIdentifiers
object
2 properties
BlockParaInclusions
object
Contains all decoded parachain inclusion information for a relay chain block
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kusama-blocks-api-openapi.yml Raw ↑

Other APIs Kusama publishes across the network.

Kusama JSON-RPC API
Kusama accounts API
Kusama ahm API
Kusama contracts API
Kusama coretime API
Kusama node API
Kusama pallets API
Kusama paras API
Kusama rc accounts API
Kusama rc API
Kusama rc blocks API
Kusama rc node API
Where this information came from

This is an independent, third-party profile of Kusama blocks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.