Skip to content

This strongly-typed, client library enables working with Elasticsearch. It is the official client maintained and supported by Elastic.


Notifications You must be signed in to change notification settings


Elasticsearch .NET Client

Repository for Elastic.Clients.Elasticsearch the official .NET client for Elasticsearch. Older branches include both previous clients, NEST and Elasticsearch.Net.

Download the latest version of Elasticsearch or sign-up for a free trial of Elastic Cloud.

The .NET client for Elasticsearch provides strongly typed requests and responses for Elasticsearch APIs. It delegates protocol handling to the Elastic.Transport library, which takes care of all transport-level concerns (HTTP connection establishment and pooling, retries, etc.).


Language clients are forward compatible; meaning that the clients support communicating with greater or equal minor versions of Elasticsearch without breaking. It does not mean that the clients automatically support new features of newer Elasticsearch versions; it is only possible after a release of a new client version. For example, a 8.12 client version won't automatically support the new features of the 8.13 version of Elasticsearch, the 8.13 client version is required for that. Elasticsearch language clients are only backwards compatible with default distributions and without guarantees made.

Elasticsearch Version Elasticsearch-NET Branch Supported
main main
8.x 8.x 8.x
7.x 7.x 7.17


Refer to the Installation section of the getting started documentation.


Refer to the Connecting section of the getting started documentation.



Please refer to the full documentation on for comprehensive information on installation, configuration and usage.


Elasticsearch 8.x Clusters

We have released the next generation of the .NET client for Elasticsearch, which aligns with v8 of Elasticsearch. We have renamed this library Elastic.Clients.Elasticsearch, and the packages are published on NuGet. The 8.0.x versions do not offer complete feature parity with the existing NEST client. We therefore recommend you thoroughly review our release notes and migration guidance before attempting to migrate existing applications to the Elastic.Clients.Elasticsearch library.

Until the new client supports all endpoints and features your application requires, you may continue to use the latest 7.17.x client to communicate with Elasticsearch v8 servers. Please review our documentation, which describes how to enable compatibility mode and secure communications with a v8 cluster.

Elasticsearch 7.x Clusters

We recommend using the latest 7.17.x NEST client to communicate with Elasticsearch v7 servers.



Copyright and License

This software is Copyright (c) 2014-2022 by Elasticsearch BV.

This is free software, licensed under The Apache License Version 2.0.