Validator attestations history

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/attestations?apikey='

{
  "status": "OK",
  "data": [
    {
      "attesterslot": 12779525,
      "committeeindex": 0,
      "epoch": 399360,
      "inclusionslot": 12779526,
      "status": 1,
      "validatorindex": 20,
      "week": 253,
      "week_start": "2025-10-07T12:00:23Z",
      "week_end": "2025-10-14T12:00:23Z"
    }
  ]
}

Validators

Validator attestations history

Retrieve attestations observed for one or more validators within a bounded epoch window. By default, the service returns data for the last 100 epochs ending at the latest processed epoch. You can narrow the range with startEpoch and endEpoch, which must lie within [latest-99, latest] and satisfy startEpoch <= endEpoch. Each item represents a scheduled attestation duty for a validator and includes the slot attested to, the inclusion slot when observed, a status flag, and convenience week boundaries for grouping in UI charts. When slim=true, the response omits the week, week_start, week_end, and committeeindex properties from each item to reduce payload size.

GET

api

validator

{indexOrPubkey}

attestations

Validator attestations history

curl --request GET \
  --url 'https://beaconcha.in/api/v1/validator/{indexOrPubkey}/attestations?apikey='

{
  "status": "OK",
  "data": [
    {
      "attesterslot": 12779525,
      "committeeindex": 0,
      "epoch": 399360,
      "inclusionslot": 12779526,
      "status": 1,
      "validatorindex": 20,
      "week": 253,
      "week_start": "2025-10-07T12:00:23Z",
      "week_end": "2025-10-14T12:00:23Z"
    }
  ]
}

Authorizations

apikey

string

query

required

Path Parameters

indexOrPubkey

string

required

Comma-separated validator indices and/or public keys (maximum 100 items by default). Comma-separated list (no spaces) of validator identifiers. Each identifier must be either:

A validator index as a base-10 integer (for example, 652648)
A BLS public key as a 96-hex-character string with or without the 0x prefix (case-insensitive)

Resolution and limits:

The server resolves public keys to validator indices before querying data.
The total number of identifiers must not exceed the server-enforced limit (default 100).
Identifiers that cannot be parsed or resolved result in HTTP 400.

Example:

"1,2,3"

Query Parameters

startEpoch

integer

Start epoch for the query window. Defaults to latest - 99. Must be within [latest-99, latest] and less than or equal to endEpoch when provided.

Required range: x >= 0

Example:

399260

endEpoch

integer

End epoch for the query window. Defaults to latest. Must be within [startEpoch, latest] when provided.

Required range: x >= 0

Example:

399359

slim

boolean

default:false

When true, return a slimmed response that excludes week, week_start, week_end, and committeeindex fields from each item.

Example:

true

Response

Matching attestations were retrieved successfully. The data array contains one entry per scheduled attestation for the specified validators within the requested epoch window. Items are sorted by epoch (descending) and then by validator index (ascending).

Standard success envelope used by all API endpoints.

status

enum<string>

HTTP-independent status of the API operation. For successful responses this is always "OK".

Available options:

OK

data

object[]

Response payload specific to the endpoint.

Show child attributes

data.attesterslot

integer

Slot number that the validator attested to (the source of the vote). Always non-negative.

Required range: x >= 0

Example:

12779525

data.committeeindex

integer

Committee index within the epoch for this attestation (>= 0). May be 0 when not recorded in this dataset.

Required range: x >= 0

Example:

0

data.epoch

integer

Epoch containing the attestation duty (>= 0).

Required range: x >= 0

Example:

399360

data.inclusionslot

integer

Slot number of the beacon block that included the attestation when it was observed on-chain. Set to 0 when the attestation was not observed/included (missed).

Required range: x >= 0

Example:

12779526

data.status

integer

Attestation status flag. 1 indicates the attestation was observed and included on-chain; 0 indicates it was missed.

Example:

1

data.validatorindex

integer

Validator index (>= 0) to whom this attestation duty applies.

Required range: x >= 0

Example:

20

data.week

integer

Epoch-based week number computed as epoch / (EpochsPerDay * 7).

Required range: x >= 0

Example:

253

data.week_start

string<date-time>

Start timestamp (UTC, RFC 3339) of the week containing epoch.

Example:

"2025-10-07T12:00:23Z"

data.week_end

string<date-time>

End timestamp (UTC, RFC 3339) of the week containing epoch.

Example:

"2025-10-14T12:00:23Z"

Attestation efficiency

Validator balance history

Introduction

API Docs

Validator attestations history

Authorizations

Path Parameters

Query Parameters

Response