---
title: "Returns a list of nodes registered at the consensus layer."
method: GET
path: "/consensus/entities/{address}/nodes"
---

# Returns a list of nodes registered at the consensus layer.

`GET /consensus/entities/{address}/nodes`

## Path parameters

- `address` string, required — An Oasis-style (bech32) address.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

A JSON object containing a list of nodes registered at the consensus layer.

- NodeList — A list of nodes registered at the consensus layer.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `entity_id` string, required
  - `nodes` Node[], required
    - `id` string, required — The public key identifying this node.
    - `entity_id` string, required — The public key identifying the entity controlling this node.
    - `expiration` integer, required — The epoch in which this node's commitment expires.
    - `tls_pubkey` string, required — The public key used for establishing TLS connections.
    - `tls_next_pubkey` string, required — The public key that will be used for establishing TLS connections upon rotation.
    - `p2p_pubkey` string, required — The unique identifier of this node on the P2P transport.
    - `consensus_pubkey` string, required — The unique identifier of this node as a consensus member
    - `roles` string, required — A bitmask representing this node's roles.

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)