METUS API Hub
Products
Products

GET

List products

GET
https://api.metahvac.com
/products/v2.0/products

Returns a paginated catalog of all products. Each item includes the SKU, SRN, type, and a HATEOAS self-link to the full record at its type-specific endpoint (e.g. /products/v2.0/indoor-units/{sku}). Note: branch controllers, branch boxes, ventilation, and accessories all have category INDOOR or OUTDOOR — use the subcategory or the self-link path to determine the specific product type.

List products › query Parameters

category
​string

Filter by product type using the route slug (e.g. indoor-units, outdoor-units, branch-controllers, branch-boxes, ventilation, accessories)

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List products › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List products › Responses

Successful product catalog

Successful product catalog response
ProductCatalogListResponse
success
​boolean · required
​ProductCatalogItem[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

List indoor units

GET
https://api.metahvac.com
/products/v2.0/indoor-units

Returns a paginated list of indoor product units with optional filters. Includes full specification, performance, and compatibility data.

List indoor units › query Parameters

series.name
​string

Filter by series name

family.name
​string

Filter by family name

brand
​string

Filter by brand name

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List indoor units › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List indoor units › Responses

Successful unit list

Successful unit list response.
success
​boolean · required
​IndoorUnitData[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

Get indoor unit by SKU

GET
https://api.metahvac.com
/products/v2.0/indoor-units/{sku}

Returns a single indoor unit by its SKU. Returns 404 if the SKU does not exist or belongs to a different product type.

Get indoor unit by SKU › path Parameters

sku
​string · required

The product SKU (brand model number) to retrieve

Get indoor unit by SKU › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get indoor unit by SKU › Responses

Successful unit lookup

Successful single unit response.
success
​boolean · required
​IndoorUnitData · required

A single an indoor unit product record.

​ErrorObject[] · required

List outdoor units

GET
https://api.metahvac.com
/products/v2.0/outdoor-units

Returns a paginated list of outdoor product units with optional filters. Includes full specification, performance, and compatibility data.

List outdoor units › query Parameters

series.name
​string

Filter by series name

family.name
​string

Filter by family name

brand
​string

Filter by brand name

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List outdoor units › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List outdoor units › Responses

Successful unit list

Successful unit list response.
success
​boolean · required
​OutdoorUnitData[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

Get outdoor unit by SKU

GET
https://api.metahvac.com
/products/v2.0/outdoor-units/{sku}

Returns a single outdoor unit by its SKU. Returns 404 if the SKU does not exist or belongs to a different product type.

Get outdoor unit by SKU › path Parameters

sku
​string · required

The product SKU (brand model number) to retrieve

Get outdoor unit by SKU › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get outdoor unit by SKU › Responses

Successful unit lookup

Successful single unit response.
success
​boolean · required
​OutdoorUnitData · required

A single an outdoor unit product record.

​ErrorObject[] · required

List branch controllers

GET
https://api.metahvac.com
/products/v2.0/branch-controllers

Returns a paginated list of branch controller units with optional filters.

List branch controllers › query Parameters

series.name
​string

Filter by series name

family.name
​string

Filter by family name

brand
​string

Filter by brand name

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List branch controllers › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List branch controllers › Responses

Successful unit list

Successful unit list response.
success
​boolean · required
​BranchControllerUnitData[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

Get branch controller by SKU

GET
https://api.metahvac.com
/products/v2.0/branch-controllers/{sku}

Returns a single branch controller unit by its SKU. Returns 404 if the SKU does not exist or belongs to a different product type.

Get branch controller by SKU › path Parameters

sku
​string · required

The product SKU (brand model number) to retrieve

Get branch controller by SKU › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get branch controller by SKU › Responses

Successful unit lookup

Successful single unit response.
success
​boolean · required
​BranchControllerUnitData · required

A single a branch controller product record.

​ErrorObject[] · required

List branch boxes

GET
https://api.metahvac.com
/products/v2.0/branch-boxes

Returns a paginated list of branch box units with optional filters.

List branch boxes › query Parameters

series.name
​string

Filter by series name

family.name
​string

Filter by family name

brand
​string

Filter by brand name

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List branch boxes › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List branch boxes › Responses

Successful unit list

Successful unit list response.
success
​boolean · required
​BranchBoxUnitData[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

Get branch box by SKU

GET
https://api.metahvac.com
/products/v2.0/branch-boxes/{sku}

Returns a single branch box unit by its SKU. Returns 404 if the SKU does not exist or belongs to a different product type.

Get branch box by SKU › path Parameters

sku
​string · required

The product SKU (brand model number) to retrieve

Get branch box by SKU › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get branch box by SKU › Responses

Successful unit lookup

Successful single unit response.
success
​boolean · required
​BranchBoxUnitData · required

A single a branch box product record.

​ErrorObject[] · required

List ventilation units

GET
https://api.metahvac.com
/products/v2.0/ventilation

Returns a paginated list of ventilation units with optional filters.

List ventilation units › query Parameters

series.name
​string

Filter by series name

family.name
​string

Filter by family name

brand
​string

Filter by brand name

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List ventilation units › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List ventilation units › Responses

Successful unit list

Successful unit list response.
success
​boolean · required
​VentilationUnitData[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

Get ventilation unit by SKU

GET
https://api.metahvac.com
/products/v2.0/ventilation/{sku}

Returns a single ventilation unit by its SKU. Returns 404 if the SKU does not exist or belongs to a different product type.

Get ventilation unit by SKU › path Parameters

sku
​string · required

The product SKU (brand model number) to retrieve

Get ventilation unit by SKU › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get ventilation unit by SKU › Responses

Successful unit lookup

Successful single unit response.
success
​boolean · required
​VentilationUnitData · required

A single a ventilation unit product record.

​ErrorObject[] · required

List accessories

GET
https://api.metahvac.com
/products/v2.0/accessories

Returns a paginated list of accessory products with optional filters.

List accessories › query Parameters

series.name
​string

Filter by series name

family.name
​string

Filter by family name

brand
​string

Filter by brand name

count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List accessories › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List accessories › Responses

Successful unit list

Successful unit list response.
success
​boolean · required
​AccessoryUnitData[] · required
​PaginationMetadata · required

Pagination information

​ErrorObject[] · required

Get accessory by SKU

GET
https://api.metahvac.com
/products/v2.0/accessories/{sku}

Returns a single accessory product by its SKU. Returns 404 if the SKU does not exist or belongs to a different product type.

Get accessory by SKU › path Parameters

sku
​string · required

The product SKU (brand model number) to retrieve

Get accessory by SKU › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get accessory by SKU › Responses

Successful accessory lookup

Successful single unit response.
success
​boolean · required
​AccessoryUnitData · required

A single an accessory product record.

​ErrorObject[] · required

List pairings

GET
https://api.metahvac.com
/products/v2.0/pairings

Returns a paginated list of product pairings and relationships (Pairing, Standalone, Combinations). Each pairing contains an array of up to 3 products with HATEOAS links to their full unit records. Filter by SKU to find all pairings a given unit participates in.

List pairings › query Parameters

sku
​string

Filter to pairings where this SKU appears as P1, P2, or P3

relType
​string · enum

Filter by relationship type

Enum values:
Pairing
Standalone
Combinations
count
​integer · min: 1 · max: 1000

Number of results per page (default: 100, min: 1, max: 1000)

Default: 100
page
​integer · min: 1

Page number (default: 1, min: 1)

Default: 1

List pairings › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

List pairings › Responses

Successful pairings list

Successful pairings list response (APIResponseV3 format)
PairingListSuccessResponse
success
​boolean · required
​PairingListData · required

Pairings list with embedded pagination

​ErrorObject[] · required

Get pairing by relationship ID

GET
https://api.metahvac.com
/products/v2.0/pairings/{relationship_id}

Returns a single product pairing by its relationship ID. The response includes all products in the pairing with HATEOAS links to their full unit records via GET /products/v2.0/units/{sku}.

Get pairing by relationship ID › path Parameters

relationship_id
​integer · required

The product relationship ID to retrieve

Get pairing by relationship ID › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get pairing by relationship ID › Responses

Successful pairing lookup

Successful single pairing response (APIResponseV3 format)
PairingSuccessResponse
success
​boolean · required
​PairingData · required

A product pairing or relationship record

​ErrorObject[] · required