> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt
> Use this file to discover all available pages before exploring further.

# V1 API Overview

> We recommend using the V2 API for all new integrations.

<Warning>
  No new features or endpoints will be added to V1. We strongly recommend the [V2 API](/api/overview) for all new projects.
</Warning>

The V1 API uses `GET` requests with path parameters and query-string authentication. It remains available for existing integrations but receives no new development.

## 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  | Single index or pubkey in URL path | Batch selectors (index, pubkey, deposit address, withdrawal address, entity, dashboard) |
| BeaconScore          | Not available                      | Available                                                                               |
| Entity benchmarking  | Not available                      | Available                                                                               |
| Dashboard management | Not available                      | Available                                                                               |

<CardGroup cols={2}>
  <Card title="Migration Guide" icon="arrow-right" href="/api/v1-to-v2-migration">
    Step-by-step instructions to migrate from V1 to V2, with endpoint mappings and code examples.
  </Card>

  <Card title="V2 Getting Started" icon="rocket" href="/api/overview">
    Get started with the V2 API — authentication, pricing, and your first request.
  </Card>
</CardGroup>