---
title: "List fork-choice frame metadata"
method: POST
path: "/api/v1/metadata"
tags: ["Metadata"]
---

# List fork-choice frame metadata

`POST /api/v1/metadata`

## 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 frame metadata.

- object
  - `data` object, required
    - `frames` FrameMetadata[], required
      - `id` string, required — The frame ID.
      - `node` string, required — The node that provided the frame. For a beacon node this is the configured node ID; for Xatu it is the Xatu Sentry ID.
      - `fetched_at` string, date-time, required — When the frame was fetched.
      - `wall_clock_slot` integer, required — A beacon-chain slot number.
      - `wall_clock_epoch` integer, required — A beacon-chain epoch number.
      - `labels` string[], required
      - `consensus_client` string, required
      - `event_source` 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)