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

# Add Packaging

> Browse the packaging catalog and add packaging to a screening.

Packaging follows the same pattern as materials — browse the catalog, add it to the screening, then set its details. There are two packaging types: regular packaging and master box.

## Browse the catalog

Call [GET /v1/packagings](/api-reference/packagings/get-packagings) to fetch available packaging items. Each item has a `publicId` and an `inputs` array. The `fieldsType` on each input determines what to send when adding it:

| `fieldsType` | What to send                                                                                   |
| :----------- | :--------------------------------------------------------------------------------------------- |
| `Default`    | `itemPublicId` only                                                                            |
| `Single`     | `itemPublicId` + one `data.publicId` from `fields` as `itemSelectableMaterialPublicId`         |
| `Multiple`   | `itemPublicId` + one or more `data.publicId` from `fields` as `itemSelectableMaterialPublicId` |

## Add the packaging

Call [POST /v1/screenings/\{screeningId}/packagings](/api-reference/packagings/add-packaging-to-a-screening) using the screening `publicId` from the [screening step](/developer/quickstart/screening).

The response includes a screening packaging `publicId` — save this for the update call.

## Set packaging details

Call the update endpoint with the screening packaging `publicId`.

**Functional unit fields** work the same as materials:

* `functionalUnitValue` — quantity in the chosen unit
* `functionalUnitKilogramValue` — conversion factor to kg; not needed if the unit is already `Kilogram`

**Packaging-specific fields:**

* `amount` — number of units
* `amountType` — `ProductsPerContainer` or `PiecesPerProduct`
* `width`, `height`, `depth` — dimensions in cm

**Per material/process input**, set one of:

* `locationListItemPublicId` — geographical origin (`lli_` prefix), from [GET /v1/geographical/locations](/api-reference/geographical-locations/get-geographical-locations)
* `transportLocationPublicId` — supplier location (`trl_` prefix), from your [created locations](/developer/quickstart/locations)

`recycleShare` — recycle percentage, only available if the item supports it.

For `Multiple` type inputs, also set `proportion` on each entry — values must sum to `1.0`.

## Master box

A master box is a secondary packaging layer used for distribution. It has all the same fields as regular packaging, plus:

* `palletPublicId` — references a pallet (`plt_` prefix); fetch available pallets from [GET /v1/packagings/pallets](/api-reference/packagings/get-pallets)
* `amountPerPallet` — number of master boxes per pallet; only set if a pallet is selected

## Next

[Retrieve Results →](/developer/quickstart/results)