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

# Overview

> Build an Aidoo compatibility selector: pick a manufacturer and indoor unit model, get the Aidoo controller to sell.

The Compatibilities area lets you build an **Aidoo compatibility selector**. Given an indoor unit manufacturer and one of its models, it returns the **Aidoo controller** that must be sold to the client to complete the installation.

<Note>
  Every model resolves to a single **article reference** — the SKU your client needs to order. That reference is what the final step of the flow returns.
</Note>

## Aidoo types

Aidoo comes in several variants. Each request targets a single Aidoo type via the `{article_type}` path segment:

| Article type    | Aidoo variant                                              |
| --------------- | ---------------------------------------------------------- |
| `AIDOO_KNX`     | Aidoo KNX DX / Air-to-water                                |
| `AIDOO_PRO`     | Aidoo Pro Wi-Fi DX / Fan coil / Air-to-water / Ventilation |
| `AIDOO_PRO_HUB` | Aidoo Pro HUB DX / Air-to-water                            |
| `AIDOO_PRO_STI` | Aidoo Pro STI                                              |
| `AIDOO_WIFI`    | Aidoo Wi-Fi                                                |
| `AIDOO_ZWAVE`   | Aidoo Z-Wave Plus                                          |
| `AIDOO_ZIGBEE`  | Aidoo ZigBee                                               |

<Warning>
  **Availability depends on the market.** Which Aidoo types exist is not fixed — it varies by `app-market`. Do not hardcode this table. Call [List Aidoo types](/compatibilities/list-article-types) for the target market to discover which Aidoo types are actually available there.
</Warning>

## The selection flow

<Steps>
  <Step title="List the available Aidoo types">
    Discover which Aidoo types are available in the target market, and present them as the first selector.

    [List Aidoo types →](/compatibilities/list-article-types)
  </Step>

  <Step title="List the brands">
    For the chosen Aidoo type, retrieve the manufacturers that have at least one compatible indoor unit.

    [List brands →](/compatibilities/list-brands)
  </Step>

  <Step title="List the brand's compatible models">
    For the chosen brand, retrieve its compatible indoor unit models, including each model's technical specs (heating and cooling power, airflow, communication protocol).

    [Get a brand with its models →](/compatibilities/get-brand)
  </Step>

  <Step title="Get the model detail and article reference">
    For the chosen model, retrieve its full detail. The `article_reference` field holds the SKU of the Aidoo controller to sell.

    [Get the model detail →](/compatibilities/get-model)
  </Step>
</Steps>

## Endpoints at a glance

<CardGroup cols={2}>
  <Card title="List Aidoo types" icon="layer-group" href="/compatibilities/list-article-types">
    The Aidoo types available in a market.
  </Card>

  <Card title="List brands" icon="list" href="/compatibilities/list-brands">
    Manufacturers compatible with an Aidoo type.
  </Card>

  <Card title="Get a brand" icon="building" href="/compatibilities/get-brand">
    A brand and all its compatible models.
  </Card>

  <Card title="Get a model" icon="barcode" href="/compatibilities/get-model">
    Full model detail with the Aidoo SKU.
  </Card>
</CardGroup>

<Tip>
  Authentication, markets and locales are shared across the whole API — see [Markets & locales](/core-concepts/markets-locales). The endpoint pages assume you are already sending the required headers.
</Tip>