---
title: "Get a single fork-choice frame by ID"
method: GET
path: "/api/v1/frames/{id}"
tags: ["Frames"]
---

# Get a single fork-choice frame by ID

`GET /api/v1/frames/{id}`

## Path parameters

- `id` string, required

## Response `200`

The requested fork-choice frame.

- object
  - `data` object, required
    - `frame` Frame, required
      - `data` ForkChoice, required — A beacon node's fork-choice dump.
        - `justified_checkpoint` Checkpoint, required
          - `epoch` string, required — A beacon-chain epoch number serialized as a string, following the beacon-API convention used by the fork-choice dump.
          - `root` string, required — A 32-byte hex-encoded root.
        - `finalized_checkpoint` Checkpoint, required
          - `epoch` string, required — A beacon-chain epoch number serialized as a string, following the beacon-API convention used by the fork-choice dump.
          - `root` string, required — A 32-byte hex-encoded root.
        - `fork_choice_nodes` ForkChoiceNode[], required
          - `slot` string, required — A beacon-chain slot number serialized as a string, following the beacon-API convention used by the fork-choice dump.
          - `block_root` string, required — A 32-byte hex-encoded root.
          - `parent_root` string, required — A 32-byte hex-encoded root.
          - `justified_epoch` string, required — A beacon-chain epoch number serialized as a string, following the beacon-API convention used by the fork-choice dump.
          - `finalized_epoch` string, required — A beacon-chain epoch number serialized as a string, following the beacon-API convention used by the fork-choice dump.
          - `weight` string, required — The node's fork-choice weight, serialized as a string.
          - `validity` 'valid' | 'invalid' | 'optimistic' | 'unknown', required — The node's validity status.
          - `execution_block_hash` string, required — A 32-byte hex-encoded root.
          - `extra_data` object
      - `metadata` 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

## Other responses

- `404` — The requested resource was not found.
- `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)