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

# Introduction

Welcome to the tipee API changelog. This tab tracks how the API evolves, for the version currently selected in the version dropdown:

* **Endpoint list** — every endpoint of the selected version, with the latest stable version it belongs to and its current status.
* **Release notes** — the detailed history of changes, grouped by date.

## How to read the endpoint list

* **Route** — the endpoint path, as you call it.
* **Title** — the endpoint name, as displayed in the API Reference tab.
* **Latest stable** — the most recent stable version the endpoint is part of; `preview` if it has not been released in a stable version yet.
* **Status :**
  * `Stable` once the endpoint is part of a stable version
  * `Testing` while it is only available in preview
  * `Deprecated` when the endpoint is scheduled for removal — the status indicates the date at which the route will be removed (this date reflects the notice period defined in the *API Terms of Use*)

## How to read the release notes

Each dated entry lists the affected endpoints and describes every change with a badge:

<div class="clb-row"><div class="clb-badges"><span class="clb clb-new">New</span><span class="clb clb-new">New version available</span></div><div class="clb-text">The endpoint is introduced in this version — or, on an older stable version, a newer revision of the endpoint exists (the entry tells you in which version).</div></div>

<div class="clb-row"><div class="clb-badges"><span class="clb clb-added">Added</span></div><div class="clb-text">Something new on an existing endpoint (a parameter, a response field, a capability).</div></div>

<div class="clb-row"><div class="clb-badges"><span class="clb clb-changed">Changed</span></div><div class="clb-text">An existing behavior or contract element is modified.</div></div>

<div class="clb-row"><div class="clb-badges"><span class="clb clb-removed">Removed</span></div><div class="clb-text">The endpoint (or one of its elements) is removed — in the `preview` version, this usually means it was migrated to a stable version.</div></div>

<div class="clb-row"><div class="clb-badges"><span class="clb clb-neutral">Request</span><span class="clb clb-neutral">Response</span></div><div class="clb-text">Which part of the contract the change applies to.</div></div>

<div class="clb-row"><div class="clb-badges"><span class="clb clb-breaking">Breaking change</span></div><div class="clb-text">The change is not backward compatible: your integration may require an update. Breaking changes normally only appear between stable versions; exceptionally, a stable route may receive one when a major bug has to be fixed, in accordance with the *API Terms of Use*.</div></div>

<div style={{marginTop: '2.5rem'}}>
  <Note>The `preview` version never flags breaking changes: preview endpoints carry no stability guarantee and may change without prior notice — see the [Versioning guide](/versions/preview/guides-and-resources/versioning#preview-endpoints).</Note>
</div>

## Stay informed

[Subscribe to Changelog notifications](https://zcmp.eu/Ktpv) to be notified when a new stable version of the tipee API is released, when an endpoint will begin to be deprecated, and of bug or security fixes that introduce a breaking change.
