Skip to main content
GET
List silos

Authorizations

X-API-Key
string
header
required

Per-manufacturer API key in the X-API-Key header, format emidat-{key_id}-{secret} where key_id is a random public handle. Issued by an owner in the Emidat dashboard; carries its own permission scopes, optional plant restrictions, and optional expiry. A revoked, expired, or unknown key returns 401. See the Authentication guide for details.

Query Parameters

plant_id
string<uuid>

Optional Emidat plant UUID to restrict the results. A UUID you cannot reach simply matches nothing — the page comes back empty.

external_id
string

Narrow the list to the silo carrying this code of yours. Optional; at most one silo matches.

cursor
string

Opaque cursor taken from the previous page's next_cursor. Omit it for the first page. Never construct or parse one — its encoding is not part of the contract. A cursor that cannot be decoded is rejected with 422. See Pagination.

limit
integer
default:50

Maximum number of items on the page. Out of range is rejected with 422. See Pagination.

Required range: 1 <= x <= 200

Response

One page of silos.

One page of silos.

data
object[]
required
next_cursor
string | null
required

Pass back as cursor to fetch the next page. null on the last page — the only reliable end-of-collection signal.