---
title: "List distinct nodes across stored frames"
method: POST
path: "/api/v1/metadata/nodes"
tags: ["Metadata"]
---

# List distinct nodes across stored frames

`POST /api/v1/metadata/nodes`

## Request body

- MetadataQuery
  - `filter` FrameFilter — Filters applied to a frame query. All fields are optional.
    - `node` string
    - `before` string, date-time
    - `after` string, date-time
    - `slot` integer — A beacon-chain slot number.
    - `epoch` integer — A beacon-chain epoch number.
    - `labels` string[]
    - `consensus_client` string
    - `event_source` string
  - `pagination` PaginationCursor — Offset-based pagination cursor.
    - `offset` integer — The number of items to skip.
    - `limit` integer — The maximum number of items to return.

## Response `200`

A page of distinct node names.

- object
  - `data` object, required
    - `nodes` string[], required
    - `pagination` PaginationResponse, required
      - `total` integer, required — The total number of matching items.

## Other responses

- `400` — The request was malformed.
- `default` — An unexpected error occurred.

---

[API](https://skmtc.dev/ethpandaops/apis/forky-api.md) · [All operations](https://skmtc.dev/ethpandaops/apis/forky-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ethpandaops/forky-api/revisions/9f25c3cc9800/schema)