> For the complete documentation index, see [llms.txt](https://docs.estela.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.estela.co/api-integration/using-the-estela-api.md).

# 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>.