# Master Data

Reference / master lists used to classify products — sections, categories, brands, families, statuses.

## Families retrieval

 - [GET /v1/{countryCode}/families](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getfamilies.md): Retrieve the master list of families (family id + locale description) for the given country.
An optional familyCodes filter can be supplied to return details for a specific subset of families.

## Get multiple families detail by list of family codes

 - [POST /v1/{countryCode}/families/query](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getfamiliesdetail.md): Retrieve one or more families detail for a list of known family codes — up to 100 per request.
The family-code list travels in the request body so it isn't URL-length limited.

## Get a family by code

 - [GET /v1/{countryCode}/families/{familyCode}](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getfamily.md): Retrieve a single family by code.

## Product statuses retrieval

 - [GET /v1/{countryCode}/statuses](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getproductstatusesmaster.md): Retrieve the master list of product statuses available for the given country.

## Get a product status by code

 - [GET /v1/{countryCode}/statuses/{code}](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getproductstatus.md): Retrieve a single product status master entry by code.

## Product sections retrieval

 - [GET /v1/{countryCode}/sections](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getsections.md): Retrieve product sections in pages.

## Get a section by code

 - [GET /v1/{countryCode}/sections/{code}](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getsection.md): Retrieve a single section by code.

## Product categories retrieval

 - [GET /v1/{countryCode}/categories](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getcategories.md): Retrieve product categories in pages.

## Get a category by code

 - [GET /v1/{countryCode}/categories/{code}](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getcategory.md): Retrieve a single category by code.

## Product brands retrieval

 - [GET /v1/{countryCode}/brands](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getbrands.md): Retrieve product brands in pages. Optionally include sub-brands via includeSubBrands=true.

## Get a brand by code

 - [GET /v1/{countryCode}/brands/{code}](https://test.docs.reece.tech/apis/product/openapi/openapi-1/master-data/getbrand.md): Retrieve a single brand by code, including all of its sub-brands.