---
title: "List nodes in the registry"
method: GET
path: "/registry/nodes"
tags: ["Splinter Registry"]
---

# List nodes in the registry

`GET /registry/nodes`

This endpoint can be used to view all or some of the nodes in the
registry. If metadata filters are provided via the "filter" query
parameter, only nodes that match the given filters will be returned. See
the Splinter registry documentation for details on metadata filters.

This endpoint requires the permission "registry.read".

## Query parameters

- `offset` integer
- `limit` integer
- `filter` string

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

The list of nodes was successfully retrieved

- object
  - `data` RegisteredNode[]
    - `identity` string
    - `endpoints` string[]
    - `display_name` string
    - `keys` string[]
    - `metadata` object
  - `paging` Paging
    - `current` string
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `first` string
    - `prev` string
    - `next` string
    - `last` string

## Other responses

- `400` — The request was malformed
- `401` — The client is unauthorized
- `500` — An internal server error occurred

---

[API](https://skmtc.dev/cargill/apis/splinterd-api.md) · [All operations](https://skmtc.dev/cargill/apis/splinterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cargill/splinterd-api/revisions/38a272c24bd9/schema)