Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kusama paras API

The paras API from Kusama — 9 operation(s) for paras.

Kusama paras API is one of 21 APIs that Kusama 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.

This API exposes 9 operations across 9 paths, and defines 15 schemas. It is described by OpenAPI 3.0.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.

9 operations 9 paths 15 schemas 9 GET

Metadata

The identity and technical contract details declared by the specification.

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

Paths & Operations 9

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

paras 9
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), ParasLeaseInfo (4 properties). Each schema is shown below with its type and property counts.

ParasCrowdloans
object
2 properties
ParachainInclusion
object
6 properties 6 required
ParasLeaseInfo
object
4 properties
ParasLeasesCurrent
object
4 properties
Para
object
3 properties
ParasHeaders
object
2 properties
ParasAuctionsCurrent
object
7 properties
BlockIdentifiers
object
2 properties
OnboardingAs
string
This property only shows up when paraLifecycle=onboarding. It describes if a particular para is onboarding as a parachain or a parathread.
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
FundInfo
object
10 properties
ParasCrowdloanInfo
object
3 properties
DigestItem
object
3 properties
ParaLifecycle
string
The possible states of a para, to take into account delayed lifecycle changes.
Paras
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kusama-paras-api-openapi.yml Raw ↑

Other APIs Kusama publishes across the network.

Kusama JSON-RPC API
Kusama accounts API
Kusama ahm API
Kusama blocks API
Kusama contracts API
Kusama coretime API
Kusama node API
Kusama pallets API
Kusama rc accounts API
Kusama rc API
Kusama rc blocks API
Kusama rc node API