> For the complete documentation index, see [llms.txt](https://docs.2050-materials.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.2050-materials.com/data-documentation/product-and-material-statuses.md).

# Product and Material Statuses

What the unverified, legacy, archived and Unassigned statuses mean for products and generic materials, where each one hides an item, and how API clients can include legacy items.

Products and generic materials can have a status that hides them from some views. This page lists each status, what it means, where the item is hidden, and whether you can ask for it.

The API does not return a status field, with one exception: `legacy_product`. `get_products` returns it, and so does the `product_data` that `get_best_match` embeds with `include_product_data`.

## Summary <a href="#summary" id="summary"></a>

| Status                    | Applies to                     | Search, API and best match             | Can you include it?              | Projects that already use it               |
| ------------------------- | ------------------------------ | -------------------------------------- | -------------------------------- | ------------------------------------------ |
| [Unverified](#unverified) | Products and generic materials | Hidden, except items your company owns | No                               | See [Unverified](#unverified)              |
| [Legacy](#legacy)         | Products and generic materials | Hidden by default                      | Yes, with `exclude_legacy=false` | Kept, and still counted in the LCA results |
| [Archived](#archived)     | Products and generic materials | Always hidden                          | No                               | Kept, and still counted in the LCA results |
| [Unassigned](#unassigned) | Products and generic materials | Usually unverified, so hidden          | No                               | No effect of its own                       |

"Search" means product and material search on the platform. "API" means `get_products`, `get_products_open_api` and `get_generic_materials`. "Best match" means `get_best_match`.

## Unverified <a href="#unverified" id="unverified"></a>

**Meaning.** 2050 Materials has not checked and published the item yet. New products and generic materials start unverified.

**Applies to** products and generic materials.

**Where it is hidden.** Unverified items are hidden from search, the API, `get_best_match`, generic material data exports, and the material lists in the project tool. Two exceptions:

* Products your company owns are returned even when they are unverified.
* Private generic materials your company owns are returned even when they are unverified.

`get_best_match` only matches verified products with an EPD, including products your company owns.

**Can you include it?** No. The API has no parameter that returns other companies' unverified items.

**In projects.** A project row that already uses a generic material keeps it if the material becomes unverified, and the project's LCA results still count it. The row then shows the material's name, but not its building applications or product types, and offers no other materials. This does not apply to your company's private materials.

## Legacy <a href="#legacy" id="legacy"></a>

**Meaning.** The item is superseded and kept for existing users.

* A legacy product is a product record that we mark as legacy, for example because its EPD certificate belongs to several products.
* A legacy generic material is a superseded material. A generic material is also legacy while its data source is legacy: then every material from that source counts as legacy.

**Applies to** products and generic materials. A legacy item can still be verified.

**Where it is hidden.** By default, legacy items are hidden from search, the API, `get_best_match`, generic material data exports, and the material lists in the project tool. Product search on the platform has an option to include legacy products.

**Can you include it?** Yes, in the API:

* `get_products`, `get_products_open_api` and `get_generic_materials`: send `exclude_legacy=false`. The default is `exclude_legacy=true`. Any other value returns 400.
* `get_best_match`: legacy products and legacy generic materials are left out of the matches by default. Put `"exclude_legacy": "false"` in `product_filters` to include legacy products, and in `material_filters` to include legacy generic materials. Any value other than `true` or `false` returns 400.

**Output field.** `legacy_product` is `true` for a legacy product. `get_products` returns it (not with `data=mini`), and you only see `true` there when you send `exclude_legacy=false`. `get_best_match` also returns it in `product_data` when you send `include_product_data`, and there it is `true` only when `product_filters` has `"exclude_legacy": "false"`. `get_generic_materials` has no legacy field.

**In projects.** A project row that already uses a legacy product or generic material keeps it, and the project's LCA results still count it. The row still loads in full and still offers its own material. A new row cannot choose a legacy generic material, and a row cannot switch to one.

## Archived <a href="#archived" id="archived"></a>

**Meaning.** The item is retired. An archived item is never verified: we unverify an item before we archive it, and an archived item cannot be verified.

**Applies to** products and generic materials.

**Where it is hidden.** Everywhere: search, the API, `get_best_match`, generic material data exports, and the material lists in the project tool. This includes items your company owns.

**Can you include it?** No. `exclude_legacy=false` does not return archived items.

**In projects.** A project row that already uses an archived product or generic material keeps it, and the project's LCA results, including recalculations, still count it. For an archived generic material, the row shows the material's name, but not its building applications or product types, and offers no other materials. A new row cannot choose an archived generic material, and a row cannot switch to one.

## Unassigned <a href="#unassigned" id="unassigned"></a>

**Meaning.** `Unassigned` is a placeholder product type, material type or building application. It means the item is not classified there yet. If you see `Unassigned` in a classification field, treat it as no value.

**Applies to** products and generic materials.

**Effect on visibility.**

* A product we process from an EPD stays unverified while its product type or any of its material types is `Unassigned`. It is then hidden as described under [Unverified](#unverified).
* A generic material is only verified once it has a material type and at least one product type. Our classification leaves `Unassigned` empty, so a generic material we could not classify usually stays unverified.

**Can you include it?** Only through its other status. `Unassigned` has no filter of its own.
