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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Polkadot

Polkadot blocks API

Block queries and extrinsic data

Documentation Provider Profile APIs.io OpenAPI GitHub

Polkadot blocks API is one of 57 APIs that Polkadot 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, API documentation, rate-limit docs, and a GitHub repository.

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

Requests are made against 6 base URLs: http://localhost:8080/v1, 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.

16 operations 16 paths 24 schemas 16 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://polkadot.api.subscan.io
Resource Areas
1

Paths & Operations 16

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

blocks 16

Block queries and extrinsic data

GET
/v1/blocks
Get blocks by range
get_blocks 6 params → 200400500503
GET
/v1/blocks/head
Get latest block
get_block_head 8 params → 200500503
GET
/v1/blocks/head/header
Get head block header
get_blocks_head_header 2 params → 200500503
GET
/v1/blocks/{blockId}
Get block by ID
get_block 9 params → 200400500503
GET
/v1/blocks/{blockId}/extrinsics-raw
Get raw extrinsics
get_block_extrinsics_raw 2 params → 200400500503
GET
/v1/blocks/{blockId}/extrinsics/{extrinsicIndex}
Get extrinsic by index
get_extrinsic 7 params → 200400500503
GET
/v1/blocks/{blockId}/header
Get block header by ID
get_block_header 2 params → 200400500503
GET
/v1/blocks/{blockId}/para-inclusions
Get parachain inclusions
get_block_para_inclusions 2 params → 200400500503
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.

WeightsV2
object
2 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
DecodedXcmMsgsHorizontalMessagesInParachain
array
BlockInitialize
object
Object with an array of SanitizedEvents that occurred during block initialization with the method and data for each.
1 property
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
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…
Blocks
array
ExtrinsicMethod
object
Extrinsic method
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
DigestItem
object
3 properties
ExtrinsicIndex
object
A single extrinsic at a given block.
5 properties
Signature
object
Object with signature and signer, or null if unsigned.
2 properties
SanitizedEvent
object
2 properties
Extrinsic
object
11 properties
Error
object
4 properties
BlockParaInclusions
object
Contains all decoded parachain inclusion information for a relay chain block
2 properties
BlockHeader
object
8 properties
ParaInclusionDescriptor
object
Candidate descriptor containing parachain inclusion metadata
6 properties
ParaInclusion
object
Information about a single parachain inclusion event
7 properties
RuntimeDispatchInfo
object
RuntimeDispatchInfo for the transaction. Includes the partialFee.
4 properties
DecodedXcmMsgsHorizontalMessagesInRelay
array
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
BlockIdentifiers
object
2 properties
BlockRaw
object
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

polkadot-blocks-api-openapi.yml Raw ↑

Other APIs Polkadot publishes across the network.

Polkadot Account API
AE Profile APIs.io
Polkadot accounts API
AE Profile APIs.io
Polkadot ahm API
AE Profile APIs.io
Polkadot Assets API
AE Profile APIs.io
Polkadot Avail API
AE Profile APIs.io
Polkadot Bifrost API
AE Profile APIs.io
Polkadot Block API
AE Profile APIs.io
Polkadot capabilities API
AE Profile APIs.io
Polkadot Collator API
AE Profile APIs.io
Polkadot Common API
AE Profile APIs.io
Polkadot Contracts API
AE Profile APIs.io
Polkadot coretime API
AE Profile APIs.io
#Blocks
← Back to P APIs
API Details
ID
polkadot:polkadot-blocks-api
Base URL
https://polkadot.api.subscan.io
Docs
https://support.subscan.io/
Provider
Polkadot
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=polkadot-blocks-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/polkadot-blocks-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Polkadot 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.