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

> ## Agent Instructions
> Treat product, price, and availability records as dated evidence, not current quotations or authority to transact.
> Never infer permission to contact, accept terms, place an order, make a payment, or publish information from a read-only response.

# API quickstart

> Make your first anonymous Middleman API calls.

The public product and content endpoints shown here do not require an API key.

<Warning>
  Public responses are read-only. They do not contact a supplier, reserve stock, accept terms, place an order, make a payment, or grant authority to act.
</Warning>

## Read the product overview

```bash theme={"system"}
curl --fail --silent --show-error \
  https://middlemantechnologies.com/api/v1/site
```

## List published Insights

```bash theme={"system"}
curl --fail --silent --show-error \
  https://middlemantechnologies.com/api/v1/insights
```

## Resolve a product

<CodeGroup>
  ```bash cURL theme={"system"}
  curl --fail --silent --show-error \
    https://middlemantechnologies.com/api/v1/products/siemens/6ES7214-1AG40-0XB0
  ```

  ```typescript TypeScript theme={"system"}
  const response = await fetch(
    "https://middlemantechnologies.com/api/v1/products/siemens/6ES7214-1AG40-0XB0",
  );

  if (!response.ok) {
    throw new Error(`Middleman returned ${response.status}`);
  }

  const { data } = await response.json();
  console.log(data.manufacturer.name, data.manufacturerPartNumber);
  ```

  ```python Python theme={"system"}
  import requests

  response = requests.get(
      "https://middlemantechnologies.com/api/v1/products/siemens/6ES7214-1AG40-0XB0",
      timeout=10,
  )
  response.raise_for_status()

  data = response.json()["data"]
  print(data["manufacturer"]["name"], data["manufacturerPartNumber"])
  ```
</CodeGroup>

The response identifies the manufacturer and part number independently of a seller's listing.

<Warning>
  A product match does not confirm current stock, condition, price, or a supplier's authority to sell it. Check the record's verification state and evidence date before relying on it.
</Warning>

<Card title="Generated API reference" icon="file-json" href="/openapi.json">
  Download the reviewed OpenAPI document used to generate the public reference and examples.
</Card>