Skip to content

Quick Start

This guide walks you through making your first API request to fetch product data.

Prerequisites

A Mando account with API access
Your API key (see Authentication)

Using cURL

Test the API directly from your terminal:

curl -X GET "https://www.mando.fi/api/secure/plu" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Example response:

[
  {
    "id": "6ec1fdd5-d50a-4233-bb5d-9a0675ed239a",
    "active": true,
    "dpt_id": "88baebc9-0898-4a5a-854c-bff13285d383",
    "image_id": null,
    "type": 6,
    "productid": "030006",
    "name": "Absolut Vodka",
    "receipt_name": "Absolut Vodka",
    "base_price": "5.0",
    "memo": "",
    "data": {
      "tags": [],
      "flags": {
        "kitchenprinter": true
      },
      "prices": {
        "7d584dfc-56a9-4048-a55b-44293200231f": {
          "type": "baseprice",
          "amount": 0
        },
        "a2e75c6d-52b3-4a38-a2ce-186c634f800f": {
          "type": "price",
          "amount": "1.00"
        }
      },
      "supply": [
        {
          "ean": "",
          "sku": "000337",
          "active": true,
          "supplier": "edada3d1-94e9-4a89-bcbd-ee834c728be6",
          "batch_name": "PLO",
          "batch_size": 700,
          "batch_value": 1894
        },
        {
          "ean": "",
          "sku": "000338",
          "active": true,
          "supplier": "edada3d1-94e9-4a89-bcbd-ee834c728be6",
          "batch_name": "LAVA",
          "batch_size": 16800,
          "batch_value": 45456
        }
      ],
      "barcodes": [],
      "pricetag": {
        "line1": "VAIN LAVOITTAIN"
      },
      "stk_type": "-",
      "allergies": [],
      "unit_type": "liquid",
      "cost_price": 1.0822857142857143,
      "sales_unit": 40,
      "modified_at": "2024-06-30T20:29:29.479Z",
      "stock_units": [
        {
          "name": "PLO",
          "value": 1894,
          "multiplier": 700,
          "balance_unit": true,
          "wastage_unit": true,
          "inventory_unit": true
        },
        {
          "name": "LAVA",
          "value": 45456,
          "multiplier": 16800,
          "balance_unit": false,
          "wastage_unit": true,
          "inventory_unit": true
        }
      ],
      "refprice_size": 40,
      "refprice_type": "weight",
      "stock_qty_warning": 10,
      "menu_items": []
    },
    "sales_history": {
      "month_sales": [
        {
          "date": "2026-01-26",
          "qty": "0.0",
          "total": "0.0"
        }
      ]
    },
    "tax_id": "3bbb3660-5b9e-11ef-a550-0800200c9a66"
  }
]

See Model reference for documentation of the response fields.

Common First Requests

List all locations

curl -X GET "https://www.mando.fi/api/secure/location" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get businessdays

curl -X GET "https://www.mando.fi/api/secure/businessday" \
  -H "Authorization: Bearer YOUR_API_KEY"

Mark a businessday id and use it in the next request.

List receipts in businessday

curl -X GET "https://www.mando.fi/api/secure/report/businessdaytx/BUSINESSDAY_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Next Steps