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

Polkadot paras API

Parachain inclusion data

Polkadot paras API is one of 57 APIs that Polkadot publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include paras. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, and a GitHub repository.

This API exposes 10 operations across 10 paths, and defines 15 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.

10 operations 10 paths 15 schemas 10 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 10

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

paras 10

Parachain inclusion data

GET
/v1/paras/{number}/inclusion
Parachain inclusion data
get_paras_inclusion 2 params → 200400500503
GET
/paras
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all registered paras (parathreads & parachains).
1 param → 200
GET
/paras/leases/current
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get general information about the current lease period.
2 params → 200
GET
/paras/auctions/current
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the status of the current auction.
1 param → 200
GET
/paras/crowdloans
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] List all stored crowdloans.
1 param → 200
GET
/paras/{paraId}/crowdloan-info
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get crowdloan information for a paraId.
2 params → 200
GET
/paras/{paraId}/lease-info
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get current and future leases as well as the lifecycle stage for a given paraId.
2 params → 200
GET
/paras/head/included-candidates
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the included (backed and considered available) parachain candidates at the specified block height or at the most recent f…
1 param → 200
GET
/paras/head/backed-candidates
[DEPRECATION NOTE: PHASED OUT ENDPOINT IN FAVOR OF CORETIME] Get the heads of the backed parachain candidates at the specified block height or at the most recent finalized head otherwise.
1 param → 200
GET
/paras/{number}/inclusion
Get relay chain inclusion information for a specific parachain block.
2 params → 200400

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are FundInfo (10 properties), ParasAuctionsCurrent (7 properties), ParachainInclusion (6 properties), ParasLeasesCurrent (4 properties). Each schema is shown below with its type and property counts.

OnboardingAs
string
This property only shows up when paraLifecycle=onboarding. It describes if a particular para is onboarding as a parachain or a parathread.
DigestItem
object
3 properties
ParachainInclusion
object
6 properties 6 required
WinningData
object
A currently winning bid and the set of lease periods the bid is for. The amount of the bid is per lease period. The bid property will be null if no bid has bee…
2 properties
Paras
object
2 properties
ParasCrowdloans
object
2 properties
ParasCrowdloanInfo
object
3 properties
ParasAuctionsCurrent
object
7 properties
ParasLeaseInfo
object
4 properties
BlockIdentifiers
object
2 properties
ParaLifecycle
string
The possible states of a para, to take into account delayed lifecycle changes.
FundInfo
object
10 properties
ParasHeaders
object
2 properties
ParasLeasesCurrent
object
4 properties
Para
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

polkadot-paras-api-openapi.yml Raw ↑

Other APIs Polkadot publishes across the network.

Polkadot Account API
Polkadot accounts API
Polkadot ahm API
Polkadot Assets API
Polkadot Avail API
Polkadot Bifrost API
Polkadot Block API
Polkadot blocks API
Polkadot capabilities API
Polkadot Collator API
Polkadot Common API
Polkadot Contracts API
Where this information came from

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