---
title: "Get bins"
method: GET
path: "/public/v1/bins"
tags: ["Bin"]
---

# Get bins

`GET /public/v1/bins`

List the bins belonging to the authenticated company, sorted oldest-first (by creation time).

A bin is a named sub-location used by bin inventory tracking — packages, batches, plants, plant groups and assembly outputs are associated to a bin to record where within a location they physically sit. Bins only exist for companies that have bin inventory tracking enabled, so this list is empty for companies that do not.

Results are paginated; follow `next_page` in the response envelope to page forward, or stop when it is null.

Required permission: `settings_permissions_bins`.

## Query parameters

- `ids` string[]
- `search` string
- `inserted_datetime` string
- `updated_datetime` string
- `page` string

## Response `200`

A list of bins

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/eb775b7b6ee0/schema)