# Basic C# client

This example is a simple client application that uses C# to access the main API (REST).
It will find all the available instruments, display the status of the first instrument, and then show all the measurements for today.

## Tutorial

### Step 1: Get the code from GitHub

- Clone the code from [this repository](https://github.com/CirrusResearch/MyCirrus).
- Or download the [ZIP file](https://github.com/CirrusResearch/MyCirrus/archive/refs/heads/master.zip) and extract it.
- Navigate to the `Examples/CSharp_Basic` folder.



```shell
git clone https://github.com/CirrusResearch/MyCirrus.git
git checkout master
cd Examples/CSharp_Basic
```

### Step 2: Add your API key

- Edit the `Program.cs` file and replace `<YOUR_API_KEY>` with your API key.


You can create an API key in the [MyCirrus website](https://mycirrus.cloud/developer-api). For more details see the [Authentication guide](/guides/authentication).


```csharp
const string Key = "<YOUR_API_KEY>"; // Your API key
```

### Step 3: Running the Example

- Run `dotnet run` to build and run the example



```shell
EXAMPLE_OUTPUT
```

## Summary

This example showed how to connect to the MyCirrus API using C#. It demonstrated how to make authenticated requests to the API, retrieve information about available instruments, and access measurement data.

You can modify the example to suit your needs, such as changing which instruments you query or how you process the retrieved data. For more information on the available API endpoints and data formats, refer to the [API Reference](/apis) section.