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

# Introduction

## What is the Emidat API?

The Emidat API is designed for manufacturers integrating from ERP systems or any
automated workflow. It lets you create product instances and supplier products
programmatically.

## Preview endpoints

Some endpoints carry a <span className="badge badge-warn">Preview</span> tag in the navigation. They are
live and supported, but their contract is not frozen yet: request and response
shapes, field names, and error codes may still change in ways that break existing
integrations, and we may do so without a deprecation period.

## Key concepts

<CardGroup cols={2}>
  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="id-card" /> Manufacturer</span>
      <span className="badge badge-neutral">Created on UI</span>
    </div>

    Your Emidat tenant that owns everything below. Your API key is scoped to your tenant automatically.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="building" /> Company</span>
      <span className="badge badge-neutral">Created on UI</span>
    </div>

    The legal entity you operate under. One manufacturer can have multiple companies.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="factory" /> Plant</span>
      <span className="badge badge-neutral">Created on UI</span>
    </div>

    One of your manufacturing sites that belongs to a company, with its own
    address, energy mix, and production processes.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="cog" /> Production Process</span>
      <span className="badge badge-neutral">Created on UI</span>
    </div>

    The manufacturing process at a plant including its inputs, outputs, energy, and
    packaging. A product instance references one to describe how it is made.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="box" /> Product Instances</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    A product instance is a specific plant-level product with a BOM. An instance
    can reference supplier products, silos and prechain products in its BOM.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="workflow" /> Prechain Product</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    An existing product instance used as an upstream ("prechain") input at one of
    your plants with an optional transport route to that plant.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="network" /> Supplier Company</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    An entity that supplies you with products or raw materials.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="factory" /> Supplier Plants</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    A supplier plant is the physical origin of a supplier product.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="package" /> Supplier Products</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    Purchased inputs to your products that are sourced from supplier plants. Each
    carries LCA impact data from a linked EPD or Emidat background datasets.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="warehouse" /> Silos</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    Optional: Group same-type supplier products at a plant into a single silo —
    one supplier today, more as they are added.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="layers" /> Composites</span>
      <span className="badge badge-accent">Created via API</span>
    </div>

    Optional: Define a reusable mix of materials by percentage at a plant.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="atom" /> Elementary</span>
      <span className="badge badge-info">Emidat managed</span>
    </div>

    A material type from Emidat's global catalog (e.g., cement, glass, aluminium). Emidat maintains these.
  </Card>

  <Card>
    <div className="card-header">
      <span className="card-header-title"><Icon icon="tags" /> Material Type</span>
      <span className="badge badge-alt">Classification</span>
    </div>

    How a supplier product's material is classified: either an Emidat elementary or one of your own
    composites. Set it when you create a supplier product.
  </Card>
</CardGroup>
