Skip to main content
GET
Get silo

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.

Path Parameters

id
string<uuid>
required

The silo's Emidat UUID.

Response

Silo.

A silo has the same ingredients across all years, with quantities entered per year. Calculation requires an explicit amount for every ingredient in the selected year and a positive total. Missing quantities are incomplete; zero means no contribution. These rules apply to both supplier and prechain ingredients. Existing supplier-only compositions retain their historical shares through a one-time backfill of implicit zeros.

id
string<uuid>
required

Emidat-assigned silo UUID.

external_id
string | null
required

Your own code for this silo, null when none is set. BOM entries reference it by its Emidat id, not this code.

Example:

"CEMENT_SILO_MUNICH_1"

plant_id
string<uuid>
required

The plant's Emidat UUID.

name
string
required

Human-readable silo name.

Example:

"Cement Silo 1 (Munich)"

items
object[]
required

Supplier products and prechain products constituting this silo, with annual quantities.

One supplier product contributing to a silo, with the volumes purchased from that supplier per calendar year. All items in a silo share the same material type — the same elementary, or the same composite; the unit is derived from it. Missing annual quantities block calculation; enter an explicit zero when this supplier contributes nothing that year.

created_at
string<date-time>
required