Get a bin

GET

/public/v1/bins/{id}

Fetch a single bin by ID.

Returns 404 if no bin with that ID belongs to the authenticated company — the lookup is scoped to your company, so an ID from another company is indistinguishable from one that does not exist.

Required permission: settings_permissions_bins.

Authorization

Bearer

headerAuthorizationBearer <token>

API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.

Path Parameters

id*string

The bin's ID.

Response Body

A single bin

*/*

response

A single bin

data?

A bin used to track where inventory is physically stored

Example Request

curl -X GET 'https://app.distru.com/public/v1/bins/ec41bdb1-6034-4005-8dac-688a2bdce970'

Example Request

curl -X GET 'https://app.distru.com/public/v1/bins/ec41bdb1-6034-4005-8dac-688a2bdce970'

Example ResponseSchema

{
  "data": {
    "id": "ec41bdb1-6034-4005-8dac-688a2bdce970",
    "inserted_datetime": "2026-08-24T16:01:06.426139Z",
    "name": "Cold Room",
    "updated_datetime": "2026-08-24T16:01:06.426139Z"
  }
}

{  "data": {    "id": "ec41bdb1-6034-4005-8dac-688a2bdce970",    "inserted_datetime": "2026-08-24T16:01:06.426139Z",    "name": "Cold Room",    "updated_datetime": "2026-08-24T16:01:06.426139Z"  }}

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

Authorization

Path Parameters

Response Body