---
title: "Get execution payload bids for a slot"
method: GET
path: "/v1/slot/{slotOrHash}/bids"
tags: ["Slot"]
---

# Get execution payload bids for a slot

`GET /v1/slot/{slotOrHash}/bids`

Returns all execution payload bids submitted for a slot (ePBS, gloas+), including bids targeting other forks or deeper ancestors (reorg bids). Each bid is classified against the slot's actual block parent chain.

## Path parameters

- `slotOrHash` string, required

## Response `200`

OK

- ApiAPISlotBidsResponse
  - `data` ApiAPISlotBidsData
    - `bids` ApiAPISlotBid[]
      - `block_hash` string
      - `builder_index` integer
      - `builder_name` string
      - `candidate_key` string — CandidateKey is the buildoor-style candidate identifier (parent_full, parent_empty, grandparent_full, grandparent_empty, ancestor-N_full/-empty); empty for orphaned-fork and unknown-parent bids.
      - `el_parent_slot` integer — ElParentSlot is the slot whose payload block hash matches the bid's parent hash, i.e. the EL head the bid builds on (omitted if not resolvable).
      - `el_parent_unrevealed` boolean — ElParentUnrevealed: the bid's parent hash matches a committed payload hash that was never revealed - such a bid can never become valid.
      - `el_payment` integer
      - `fee_recipient` string
      - `gas_limit` integer
      - `is_self_built` boolean
      - `is_winning` boolean
      - `parent_class` string — Bid target classification relative to the slot's actual block parent chain. ParentClass: "parent" (targets the block's actual beacon parent), "reorg" (targets a deeper ancestor, orphaning ReorgDepth blocks), "orphaned" (targets a block outside the block's chain), "unknown" (parent root not resolvable).
      - `parent_full` boolean — ParentFull: the bid builds on the targeted block's own payload (full) rather than an earlier payload (empty).
      - `parent_hash` string
      - `parent_root` string
      - `parent_slot` integer — ParentSlot is the slot of the targeted beacon parent block (0 if unknown).
      - `reorg_depth` integer
      - `seen_count` integer — Gossip visibility: SeenCount of SeenTotal connected clients observed the bid on gossip. SeenTotal 0 = no observation data available for this bid. Per-client details are served by the /slot/{slotOrHash}/bidseen page endpoint.
      - `seen_total` integer
      - `slot` integer
      - `total_value` integer
      - `value` integer
    - `block_root` string
    - `count` integer
    - `slot` integer
  - `status` string

## Other responses

- `400` — Invalid slot number or root format
- `404` — Slot not found
- `500` — Internal server error

---

[API](https://skmtc.net/ethpandaops/apis/dora-explorer-api.md) · [All operations](https://skmtc.net/ethpandaops/apis/dora-explorer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ethpandaops/dora-explorer-api/versions/73a9fb0d9c41/schema)