# Using the eStela API

eStela provides a REST API to help you retrieve race data, manage your fleet (boats), and submit wind measurements from third-party apps.

The canonical, up-to-date reference lives in your admin panel here:

<https://admin.estela.co/edit/integrations>

***

#### Base URL:&#x20;

`https://estela.co`

#### Authentication

Your API requests must include your API Access Key using one of these methods:

* Authorization header (recommended)\
  \
  `curl https://estela.co/api/v2.0/races`\
  `-H "Authorization: Bearer {YOUR_API_KEY}"`
* Query parameter
  * api\_token={YOUR\_API\_KEY}

Your API key is generated once. If you need to regenerate it, contact support.

#### Main Resources

**Tracking Sessions (Races)**

* `GET /api/v2.0/races`
* `GET /api/v2.0/races/{id}`

Returns tracking sessions associated with your account (name, start/end, link, picture, etc.).

**Players (Boats in a Race + Stats)**

* `GET /api/v2.0/races/{id}/players`

Returns all registered players in a tracking session, including timing and performance fields (ranking, elapsed time, avg/max SOG, distance sailed, etc.).

**Course Download**

* `GET /api/v2.0/races/{id}/course.gpx`
* `GET /api/v2.0/races/{id}/course.csv`

Downloads the configured course in GPX or CSV format.

**Boats (Fleet Management)**

* `GET /api/v2.0/boats`
* `POST /api/v2.0/boats`
* `GET /api/v2.0/boats/{id}`
* `PUT /api/v2.0/boats/{id}`
* `DELETE /api/v2.0/boats/{id}`

Create and manage boats in your account (name, model, class, sail number/number, MMSI, color, etc.).

**Wind (Submit Measurements)**

* `POST /api/v2.0/wind`

Submit real-time wind for an ongoing tracking session (includes at least race\_id, speed, direction).

***

#### Partner Applications

If you’re building an integration and want your app listed under Partner Applications, contact us at <info@estela.co>.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.estela.co/api-integration/using-the-estela-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.