V1 API Overview

No new features or endpoints will be added to V1. We strongly recommend the V2 API for all new projects.

The V1 API uses GET requests with path parameters and query-string authentication. It remains available for existing integrations but receives no new development. This reference lists only the V1 endpoints that stay until V2 covers them. Endpoints that V2 covers, and endpoints that are being phased out, are no longer listed, but they still respond. The migration guide maps each of them to its V2 replacement.

Key Differences from V2

Aspect	V1 (this section)	V2 (recommended)
HTTP method	`GET` with path params	`POST` with JSON body
Authentication	`?apikey=` or `apikey:` header	`Authorization: Bearer`
Pagination	Offset-based	Cursor-based
Validator selection	Up to 100 comma-separated indices or pubkeys in the URL path	Batch selectors (index, pubkey, dashboard; deposit address, withdrawal address, and entity on Scale and Enterprise plans)
BeaconScore®	Not available	Available
Entity benchmarking	Not available	Available
Dashboard management	Not available	Available

Migration Guide

Step-by-step instructions to migrate from V1 to V2, with endpoint mappings and code examples.

V2 Getting Started

Get started with the V2 API — authentication, pricing, and your first request.

Introduction

V2 API Docs

V1 API Docs

Key Differences from V2

Migration Guide

V2 Getting Started