/paras - Polkadot

Example code for the /paras REST method. Complete guide on how to use /paras REST in GetBlock Web3 documentation.

This endpoint returns the parachains registered on the relay chain and their lifecycle status. It is a relay-chain endpoint.

Endpoint

GET /paras

Query Parameters

Parameter	Type	Required	Description
at	string	No	Block height or hash to query at

Request

cURL

curl --location 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/paras'

JavaScript

example.js

const response = await fetch('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/paras');
const data = await response.json();
console.log(data);

Python

example.py

import requests

response = requests.get('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/paras')
print(response.json())

Response

{
  "at": {
    "hash": "0x255bc00927df8d33d561792635cbc6bde480a0a505eef5ff28630ece3fc15b32",
    "height": "6754362"
  },
  "paras": [
    {
      "paraId": "1000",
      "paraLifecycle": "Parachain"
    },
    {
      "paraId": "2004",
      "paraLifecycle": "Parachain"
    }
  ]
}

Response Fields

Field	Type	Description
paras	array	Registered parachains
paras[].paraId	string	The parachain ID
paras[].paraLifecycle	string	Lifecycle state (Parachain, Parathread, Onboarding)

Use Cases

• Parachain Explorers: List registered parachains

• Ecosystem Tools: Track parachain lifecycle states

• Monitoring: Detect onboarding or offboarding paras

• Analytics: Map the parachain landscape