Itemoo API for ERP

Відповідь 200 · application/json

object

• brandstring | nullобов’язкове
• slugstring | nullобов’язкове
• keystringобов’язкове
  Name of the API key
• scopesstring[]обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/v1/ping' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/ping', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/ping');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Відповідь 200 · application/json

Item[]

• skustring | nullобов’язкове
  ERP SKU paired with the item; null = not paired yet
• eanstring | nullобов’язкове
• catalogNostring | nullобов’язкове
• namestringобов’язкове
• productstringобов’язкове
  Product (page) name
• productSkustringобов’язкове
  SKU of the product model that groups the items on one page
• pricenumber | nullобов’язкове
  Gross price in the brand currency
• stockinteger | nullобов’язкове
  null = stock is not tracked (unlimited sale)
• reservedintegerобов’язкове
  Units held by orders not yet acknowledged by the ERP
• availablebooleanобов’язкове

Приклад

curl -X GET 'https://itemoo.eu/v1/items' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/items', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/items');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• itemsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
    SKU in your ERP
  • catalogNostring
    Catalogue number used to find the item
  • eanstring
    EAN/GTIN used to find the item
  • namestring
    Name in the ERP — helps pairing by hand
  • priceGrossnumber
  • priceNetnumber
  • vatRate"0" | "5" | "8" | "23" | "exempt" | "outside_scope"
    23 | 8 | 5 | 0 | exempt (VAT-exempt) | outside_scope (outside the scope of VAT)
  • pricesobject[]
    Prices in the brand additional markets — never overwritten by exchange-rate recalculation
    ›Поля

    • currencystringобов’язкове
    • priceGrossnumber | nullобов’язкове
      Gross price in the market currency; null returns the market to the recalculated price
• dryRunboolean
  true = preview, nothing is saved

Відповідь 200 · application/json

object

• receivedintegerобов’язкове
• alreadyPairedintegerобов’язкове
• pairedobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • itemKeystringобов’язкове
    Item key in Itemoo
  • by"ean" | "catalogNo"обов’язкове
• unmatchedobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • catalogNostring | nullобов’язкове
  • eanstring | nullобов’язкове
• conflictsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • reasonstringобов’язкове
• appliedbooleanобов’язкове
  false for dryRun
• pricesobjectобов’язкове
  ›Поля

  • updatedintegerобов’язкове
  • errorsobject[]обов’язкове
    ›Поля

    • skustringобов’язкове
    • reasonstringобов’язкове

Приклад

curl -X PUT 'https://itemoo.eu/v1/items' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"KAW-250","ean":"5901234123457"},{"sku":"KAW-1000","catalogNo":"K-1000","priceGross":89.9,"vatRate":"23"}],"dryRun":true}'

const res = await fetch('https://itemoo.eu/v1/items', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "items": [
      {
        "sku": "KAW-250",
        "ean": "5901234123457"
      },
      {
        "sku": "KAW-1000",
        "catalogNo": "K-1000",
        "priceGross": 89.9,
        "vatRate": "23"
      }
    ],
    "dryRun": true
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/items');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"items":[{"sku":"KAW-250","ean":"5901234123457"},{"sku":"KAW-1000","catalogNo":"K-1000","priceGross":89.9,"vatRate":"23"}],"dryRun":true}',
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• itemsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • qtyintegerобов’язкове

Відповідь 200 · application/json

object

• savedintegerобов’язкове
• soldOutintegerобов’язкове
  Items that became unavailable (stock 0)
• reservedDeductedintegerобов’язкове
  Units subtracted for unacknowledged orders
• unknownSkustring[]обов’язкове
  Saved, but no item has this SKU yet — takes effect once paired in the panel
• errorsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • reasonstringобов’язкове

Приклад

curl -X PUT 'https://itemoo.eu/v1/stock' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"KAW-250","qty":12},{"sku":"KAW-1000","qty":0}]}'

const res = await fetch('https://itemoo.eu/v1/stock', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "items": [
      {
        "sku": "KAW-250",
        "qty": 12
      },
      {
        "sku": "KAW-1000",
        "qty": 0
      }
    ]
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/stock');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"items":[{"sku":"KAW-250","qty":12},{"sku":"KAW-1000","qty":0}]}',
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• itemsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • lotstringобов’язкове
  • producedAtstring
    ISO date (YYYY-MM-DD) or date-time
  • expiresAtstring
    ISO date (YYYY-MM-DD) or date-time
  • qtyinteger

Відповідь 200 · application/json

object

• createdintegerобов’язкове
• updatedintegerобов’язкове
• unknownSkustring[]обов’язкове
• errorsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • lotstringобов’язкове
  • reasonstringобов’язкове

Приклад

curl -X PUT 'https://itemoo.eu/v1/batches' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"KAW-250","lot":"L2026-10","producedAt":"2026-10-01","expiresAt":"2027-10-01","qty":500}]}'

const res = await fetch('https://itemoo.eu/v1/batches', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "items": [
      {
        "sku": "KAW-250",
        "lot": "L2026-10",
        "producedAt": "2026-10-01",
        "expiresAt": "2027-10-01",
        "qty": 500
      }
    ]
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/batches');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"items":[{"sku":"KAW-250","lot":"L2026-10","producedAt":"2026-10-01","expiresAt":"2027-10-01","qty":500}]}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

object

• ordersOrder[]обов’язкове
  ›Поля · Order

  • orderNostringобов’язкове
  • channelstringобов’язкове
    app | site | marketplace:allegro | marketplace:ebay | marketplace:amazon | erp
  • externalobject | nullобов’язкове
    The order in the sales channel; null for brand shop orders
    ›Поля

    • orderIdstringобов’язкове
    • marketplacestringобов’язкове
    • statusstring | nullобов’язкове
  • fulfilledBy"merchant" | "marketplace"обов’язкове
    marketplace = shipped by the channel warehouse (e.g. FBA) — for bookkeeping only
  • createdAtstring (date-time)обов’язкове
  • updatedAtstring (date-time)обов’язкове
  • paymentobjectобов’язкове
    ›Поля

    • status"pending" | "paid" | "failed" | "expired" | "refunded"обов’язкове
    • method"online" | "transfer" | "on_delivery" | "on_pickup" | "deferred" | "marketplace"обов’язкове
      online = card/BLIK/wallet in the shop; transfer = bank transfer; on_delivery = cash on delivery; on_pickup = paid at pickup; deferred = B2B deferred payment; marketplace = paid in the sales channel
    • paidAtstring (date-time) | nullобов’язкове
    • approval"pending" | "approved" | "rejected" | nullобов’язкове
      B2B deferred payment over the limit
  • fulfillment"new" | "packing" | "shipped" | "delivered" | "cancelled"обов’язкове
  • acknowledgedAtstring (date-time) | nullобов’язкове
    When the ERP acknowledged the order (POST /orders/ack)
  • readyToShipbooleanобов’язкове
  • currencystringобов’язкове
  • totalnumberобов’язкове
  • totalNetnumber | nullобов’язкове
  • customerDiscountnumberобов’язкове
  • buyerTypestringобов’язкове
    consumer | business
  • vatobjectобов’язкове
    ›Поля

    • scheme"domestic" | "eu-domestic" | "oss" | "intra-eu" | "export" | "marketplace-collected" | "local"обов’язкове
      domestic = seller country VAT; eu-domestic = EU consumer below the OSS threshold (seller country rates); oss = EU consumer, buyer country rates; intra-eu = intra-EU supply to a VAT-registered business, 0%; export = outside the EU, 0%; marketplace-collected = the sales channel collected the buyer country tax; local = VAT of the channel warehouse country
    • collectedByMarketplacenumber | nullобов’язкове
    • countrystring | nullобов’язкове
    • exportbooleanобов’язкове
    • buyerVatIdstring | nullобов’язкове
    • viesobject | nullобов’язкове
      ›Поля

      • statusstringобов’язкове
      • requestIdstring | nullобов’язкове
      • checkedAtstring (date-time) | nullобов’язкове
  • shippingCostnumberобов’язкове
  • discountnumberобов’язкове
  • promoCodestring | nullобов’язкове
  • promoDiscountnumberобов’язкове
  • buyerobjectобов’язкове
    ›Поля

    • emailstring | nullобов’язкове
    • namestring | nullобов’язкове
    • phonestring | nullобов’язкове
    • personalDataRemovedbooleanобов’язкове
      true = personal data was erased (GDPR or the sales channel retention); amounts and lines stay
  • shippingobjectобов’язкове
    ›Поля

    • methodstring | nullобов’язкове
    • addressobjectобов’язкове
      ›Поля

      • line1string | nullобов’язкове
      • line2string | nullобов’язкове
      • postalstring | nullобов’язкове
      • citystring | nullобов’язкове
      • countrystring | nullобов’язкове
    • pointobject | nullобов’язкове
      Pickup point (code, name, address) when chosen
      ›Поля
  • invoiceobject | nullобов’язкове
    Invoice data entered by the buyer (company, taxId, address)
    ›Поля
  • notestring | nullобов’язкове
  • carrierstring | nullобов’язкове
  • trackingNostring | nullобов’язкове
  • invoiceDocumentobject | nullобов’язкове
    Invoice attached with PUT /orders/{orderNo}/invoice
    ›Поля

    • numberstringобов’язкове
    • ksefNumberstring | nullобов’язкове
    • issuedAtstring | nullобов’язкове
    • hasPdfbooleanобов’язкове
  • itemsOrderLine[]обов’язкове
    ›Поля · OrderLine

    • skustring | nullобов’язкове
    • catalogNostring | nullобов’язкове
    • namestringобов’язкове
    • qtynumberобов’язкове
    • unitPricenumberобов’язкове
    • discountnumberобов’язкове
      Promotion and customer discount on the whole line (not per unit)
    • customerDiscountnumberобов’язкове
      Part of the discount coming from the B2B customer discount
    • vatRatestring | nullобов’язкове
    • vatCountrystring | nullобов’язкове
      Country of the VAT rate (OSS: the buyer country)
    • netTotalnumber | nullобов’язкове
      Net value of the line after discounts
    • giftbooleanобов’язкове
    • lotsobject[]обов’язкове
      Batches the line shipped from
      ›Поля

      • lotstringобов’язкове
      • qtynumberобов’язкове
    • unitsstring[]обов’язкове
      Itemoo QR codes of the shipped units
• nextstring (date-time) | nullобов’язкове
  Pass as updatedSince to get the next page; null = no more pages

Приклад

curl -X GET 'https://itemoo.eu/v1/orders?unacknowledged=true&limit=50' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/orders?unacknowledged=true&limit=50', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders?unacknowledged=true&limit=50');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · text/csv, application/xml

Orders file (attachment).

Стовпці файлу замовлень

XML

Приклад

curl -X GET 'https://itemoo.eu/v1/orders/export?format=csv' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/orders/export?format=csv', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders/export?format=csv');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• orderNosstring[]обов’язкове

Відповідь 200 · application/json

object

• acknowledgedintegerобов’язкове
• unknownstring[]обов’язкове
  Order numbers that do not exist in the brand

Приклад

curl -X POST 'https://itemoo.eu/v1/orders/ack' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"orderNos":["ITM-2026-000123"]}'

const res = await fetch('https://itemoo.eu/v1/orders/ack', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "orderNos": [
      "ITM-2026-000123"
    ]
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders/ack');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"orderNos":["ITM-2026-000123"]}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• itemsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • lotstringобов’язкове
  • qtyinteger
    The whole line quantity by default

Відповідь 200 · application/json

object

• savedintegerобов’язкове
• errorsstring[]обов’язкове
  Rows that were skipped, as human-readable messages

Приклад

curl -X PUT 'https://itemoo.eu/v1/orders/ITM-2026-000123/lots' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"KAW-250","lot":"L2026-10","qty":2}]}'

const res = await fetch('https://itemoo.eu/v1/orders/ITM-2026-000123/lots', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "items": [
      {
        "sku": "KAW-250",
        "lot": "L2026-10",
        "qty": 2
      }
    ]
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders/ITM-2026-000123/lots');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"items":[{"sku":"KAW-250","lot":"L2026-10","qty":2}]}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• itemsobject[]обов’язкове
  ›Поля

  • skustringобов’язкове
  • codesstring[]обов’язкове
    Itemoo QR codes; an empty list removes the units

Відповідь 200 · application/json

object

• savedintegerобов’язкове
• errorsstring[]обов’язкове
  Rows that were skipped, as human-readable messages

Приклад

curl -X PUT 'https://itemoo.eu/v1/orders/ITM-2026-000123/units' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"KAW-250","codes":["U7K2M9QX"]}]}'

const res = await fetch('https://itemoo.eu/v1/orders/ITM-2026-000123/units', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "items": [
      {
        "sku": "KAW-250",
        "codes": [
          "U7K2M9QX"
        ]
      }
    ]
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders/ITM-2026-000123/units');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"items":[{"sku":"KAW-250","codes":["U7K2M9QX"]}]}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• numberstringобов’язкове
• ksefNumberstring
• issuedAtstring
  ISO date (YYYY-MM-DD) or date-time
• pdfBase64string
  PDF file as base64 — the whole request is limited to 2 MB, so about 1.4 MB of PDF
• notifyCustomerboolean
  false = no email to the customer

Відповідь 200 · application/json

object

• numberstringобов’язкове
• ksefNumberstring | nullобов’язкове
• issuedAtstring (date-time)обов’язкове
• hasPdfbooleanобов’язкове
• notifiedbooleanобов’язкове
  The customer got an email with the invoice

Приклад

curl -X PUT 'https://itemoo.eu/v1/orders/ITM-2026-000123/invoice' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"number":"FV/2026/10/123","issuedAt":"2026-10-16"}'

const res = await fetch('https://itemoo.eu/v1/orders/ITM-2026-000123/invoice', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "number": "FV/2026/10/123",
    "issuedAt": "2026-10-16"
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders/ITM-2026-000123/invoice');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"number":"FV/2026/10/123","issuedAt":"2026-10-16"}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• status"packing" | "shipped" | "delivered" | "cancelled"обов’язкове
• carrierstring
• trackingNostring
• reasonstring
  Cancellation reason shown to the customer
• lotsobject[]
  Batches shipped, like PUT /orders/{orderNo}/lots
  ›Поля

  • skustringобов’язкове
  • lotstringобов’язкове
  • qtyinteger
    The whole line quantity by default

Відповідь 200 · application/json

OrderAfterStatusChange

• orderNostringобов’язкове
• channelstringобов’язкове
  app | site | marketplace:allegro | marketplace:ebay | marketplace:amazon | erp
• externalobject | nullобов’язкове
  The order in the sales channel; null for brand shop orders
  ›Поля

  • orderIdstringобов’язкове
  • marketplacestringобов’язкове
  • statusstring | nullобов’язкове
• fulfilledBy"merchant" | "marketplace"обов’язкове
  marketplace = shipped by the channel warehouse (e.g. FBA) — for bookkeeping only
• createdAtstring (date-time)обов’язкове
• updatedAtstring (date-time)обов’язкове
• paymentobjectобов’язкове
  ›Поля

  • status"pending" | "paid" | "failed" | "expired" | "refunded"обов’язкове
  • method"online" | "transfer" | "on_delivery" | "on_pickup" | "deferred" | "marketplace"обов’язкове
    online = card/BLIK/wallet in the shop; transfer = bank transfer; on_delivery = cash on delivery; on_pickup = paid at pickup; deferred = B2B deferred payment; marketplace = paid in the sales channel
  • paidAtstring (date-time) | nullобов’язкове
  • approval"pending" | "approved" | "rejected" | nullобов’язкове
    B2B deferred payment over the limit
• fulfillment"new" | "packing" | "shipped" | "delivered" | "cancelled"обов’язкове
• acknowledgedAtstring (date-time) | nullобов’язкове
  When the ERP acknowledged the order (POST /orders/ack)
• readyToShipbooleanобов’язкове
• currencystringобов’язкове
• totalnumberобов’язкове
• totalNetnumber | nullобов’язкове
• customerDiscountnumberобов’язкове
• buyerTypestringобов’язкове
  consumer | business
• vatobjectобов’язкове
  ›Поля

  • scheme"domestic" | "eu-domestic" | "oss" | "intra-eu" | "export" | "marketplace-collected" | "local"обов’язкове
    domestic = seller country VAT; eu-domestic = EU consumer below the OSS threshold (seller country rates); oss = EU consumer, buyer country rates; intra-eu = intra-EU supply to a VAT-registered business, 0%; export = outside the EU, 0%; marketplace-collected = the sales channel collected the buyer country tax; local = VAT of the channel warehouse country
  • collectedByMarketplacenumber | nullобов’язкове
  • countrystring | nullобов’язкове
  • exportbooleanобов’язкове
  • buyerVatIdstring | nullобов’язкове
  • viesobject | nullобов’язкове
    ›Поля

    • statusstringобов’язкове
    • requestIdstring | nullобов’язкове
    • checkedAtstring (date-time) | nullобов’язкове
• shippingCostnumberобов’язкове
• discountnumberобов’язкове
• promoCodestring | nullобов’язкове
• promoDiscountnumberобов’язкове
• buyerobjectобов’язкове
  ›Поля

  • emailstring | nullобов’язкове
  • namestring | nullобов’язкове
  • phonestring | nullобов’язкове
  • personalDataRemovedbooleanобов’язкове
    true = personal data was erased (GDPR or the sales channel retention); amounts and lines stay
• shippingobjectобов’язкове
  ›Поля

  • methodstring | nullобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • line1string | nullобов’язкове
    • line2string | nullобов’язкове
    • postalstring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
  • pointobject | nullобов’язкове
    Pickup point (code, name, address) when chosen
    ›Поля
• invoiceobject | nullобов’язкове
  Invoice data entered by the buyer (company, taxId, address)
  ›Поля
• notestring | nullобов’язкове
• carrierstring | nullобов’язкове
• trackingNostring | nullобов’язкове
• invoiceDocumentobject | nullобов’язкове
  Invoice attached with PUT /orders/{orderNo}/invoice
  ›Поля

  • numberstringобов’язкове
  • ksefNumberstring | nullобов’язкове
  • issuedAtstring | nullобов’язкове
  • hasPdfbooleanобов’язкове
• itemsOrderLine[]обов’язкове
  ›Поля · OrderLine

  • skustring | nullобов’язкове
  • catalogNostring | nullобов’язкове
  • namestringобов’язкове
  • qtynumberобов’язкове
  • unitPricenumberобов’язкове
  • discountnumberобов’язкове
    Promotion and customer discount on the whole line (not per unit)
  • customerDiscountnumberобов’язкове
    Part of the discount coming from the B2B customer discount
  • vatRatestring | nullобов’язкове
  • vatCountrystring | nullобов’язкове
    Country of the VAT rate (OSS: the buyer country)
  • netTotalnumber | nullобов’язкове
    Net value of the line after discounts
  • giftbooleanобов’язкове
  • lotsobject[]обов’язкове
    Batches the line shipped from
    ›Поля

    • lotstringобов’язкове
    • qtynumberобов’язкове
  • unitsstring[]обов’язкове
    Itemoo QR codes of the shipped units
• unchangedtrue
  The same status was sent again — nothing changed, no email

Приклад

curl -X PUT 'https://itemoo.eu/v1/orders/ITM-2026-000123' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"status":"shipped","carrier":"InPost","trackingNo":"6200000000000000"}'

const res = await fetch('https://itemoo.eu/v1/orders/ITM-2026-000123', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "status": "shipped",
    "carrier": "InPost",
    "trackingNo": "6200000000000000"
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/orders/ITM-2026-000123');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"status":"shipped","carrier":"InPost","trackingNo":"6200000000000000"}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

BrandPassport

• level"public" | "legit" | "authority"обов’язкове
• recipientstring
  Name of the access grant used
• versionPassportVersion | nullобов’язкове
  ›Поля · PassportVersion

  • hashstringобов’язкове
    SHA-256 of the canonical (RFC 8785) composition of layer versions and the unit event chain head
  • layersobject[]обов’язкове
    ›Поля

    • subject"product" | "variant" | "batch" | "unit"обов’язкове
    • versionintegerобов’язкове
    • hashstringобов’язкове
  • eventsHeadstring | nullобов’язкове
  • atstring (date-time)
    Present for a passport read at a point in time (?at=)
• backupobject | nullобов’язкове
  Backup copy of the passport kept by a DPP service provider (Regulation (EU) 2024/1781 Annex III point (l)), when the brand designated one
  ›Поля

  • providerstringобов’язкове
  • urlstringобов’язкове
• identityProductIdentityобов’язкове
  ›Поля · ProductIdentity

  • codestringобов’язкове
    Itemoo code from the QR label
  • level"unit" | "batch" | "variant" | "model"обов’язкове
  • gtinstring | nullобов’язкове
  • skustring | nullобов’язкове
  • variantobject
    ›Поля

    • labelstringобов’язкове
    • catalogNostring | nullобов’язкове
  • lotstring | nullобов’язкове
  • serialstring | nullобов’язкове
  • expiresAtstring (date-time) | nullобов’язкове
  • statusstringобов’язкове
    Batch status: ACTIVE | RECALLED | …
  • uniqueProductIdentifierstringобов’язкове
    Unique product identifier of this code (EN 18219:2026): GS1 Digital Link with the batch and serial number of the code level, or the code address /q/{code} without a GTIN
• productProductSummaryобов’язкове
  ›Поля · ProductSummary

  • namestringобов’язкове
  • brandstringобов’язкове
  • category"chemicals" | "cosmetics" | "medical" | "food" | "supplements" | "electronics" | "appliances" | "batteries" | "textiles" | "furniture" | "toys" | "construction" | "other" | nullобов’язкове
    Regulatory product type — decides the mandatory information: chemicals | cosmetics | medical | food | supplements | electronics | appliances | batteries | textiles | furniture | toys | construction | other
  • descriptionstringобов’язкове
  • imagestring
  • translationsobject
    Name and description in every language the brand provides (ISO 639-1 code → text); name and description above are in the language of the response
    ›Поля

    • namemap<string, string>обов’язкове
    • descriptionmap<string, string>обов’язкове
• manufacturerEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))
  • identifiersobject[]
    Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• responsiblePersonEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))
  • identifiersobject[]
    Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• importerEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))
  • identifiersobject[]
    Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• authorisedRepresentativeEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))
  • identifiersobject[]
    Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• facilityEconomicOperator | nullобов’язкове
  ›Поля · EconomicOperator

  • namestringобов’язкове
  • addressobjectобов’язкове
    ›Поля

    • streetstring | nullобов’язкове
    • postalCodestring | nullобов’язкове
    • citystring | nullобов’язкове
    • countrystring | nullобов’язкове
      ISO 3166-1 alpha-2
  • emailstring | nullобов’язкове
  • phonestring | nullобов’язкове
    Shown only at the access level the brand chose for it (default: persons with a legitimate interest)
  • source"company" | "registry"обов’язкове
    company = the brand company data; registry = an operator from the company operator register designated in the passport
  • tradeNamestring | null
    Registered trade name or trade mark (Regulation (EU) 2024/1781 Art. 27(6), 29(3))
  • identifiersobject[]
    Unique operator or facility identifiers (Regulation (EU) 2024/1781 Annex III points (g)–(k), Art. 12; EN 18219:2026 Clause 6 — ISO/IEC 6523 or ISO/IEC 15459)
    ›Поля

    • scheme"gln" | "duns" | "lei" | "vat" | "iso15459"обов’язкове
      gln = GS1 GLN, duns = D-U-N-S, lei = Legal Entity Identifier (ISO 17442), vat = EU VAT number with country prefix, iso15459 = identifier of another ISO/IEC 15459 issuing agency
    • iacstring
      Issuing agency code (ISO/IEC 15459-2 register): 0–9 for GS1, UN for D&B, otherwise the registered agency code; absent for lei and vat
    • valuestringобов’язкове
  • eoristring | null
    EORI number (importer, Annex III point (j)) — shown only at the access level the brand chose for it (default: legitimate interest)
• languagestringобов’язкове
• publishedbooleanобов’язкове
• recallRecall | nullобов’язкове
  ›Поля · Recall

  • activetrueобов’язкове
  • certainbooleanобов’язкове
    true = this exact code is recalled; false = the batch is unknown and may be affected
  • scope"product" | "batch" | "lotRange"обов’язкове
    product = the whole product; batch = one batch; lotRange = a range of batch numbers (lotFrom–lotTo)
  • reasonstringобов’язкове
  • instructionsstring | nullобов’язкове
  • lotFromstring | nullобов’язкове
  • lotTostring | nullобов’язкове
  • kind"recall" | "notice"
    recall = the product is recalled; notice = safety notice, the product is not withdrawn
• factsProvenanceFact[]обов’язкове
  ›Поля · ProvenanceFact

  • keystring
    Stable English key of a standard fact (origin, materials, battery.capacityAh, chemical.ufi, …); absent for parameters defined by the brand — match on it, not on the translated name
  • namestringобов’язкове
    Fact name in the response language
  • valuestringобов’язкове
  • provenanceobject
    ›Поля

    • sourcestringобов’язкове
      Document or block the fact comes from
    • versionstring
    • documentUrlstring
    • assertedBystringобов’язкове
      Brand that published the fact
    • assertedAtstring
• documentsDocument[]обов’язкове
  ›Поля · Document

  • titlestringобов’язкове
  • urlstringобов’язкове
  • kindstringобов’язкове
    certificate | declaration | repair | dpp | manual | sds | …
  • versionstring
  • accessstring
    public | legit | authority — present on documents beyond the public level
  • docIdstring
    Library document identifier — the same as in { docId } values of document fields
  • languagestring
    Language of the file (ISO 639-1 code, e.g. de), set by the brand at the document version; absent — multilingual file or not specified
• componentsPassportComponent[]обов’язкове
  Components with their own passport visible at this level (Regulation (EU) 2024/1781 Art. 2(4); CIRPASS-2 D4.1 recommendation 5)
  ›Поля · PassportComponent

  • codestring | nullобов’язкове
    Itemoo code of the component passport (unit, batch, variant or model — also of another brand)
  • uristring | nullобов’язкове
    Address of a component passport outside Itemoo (DPP URL or GS1 Digital Link)
  • urlstringобов’язкове
    Where to read the component passport
  • rolestring | nullобов’язкове
  • nameanyобов’язкове
  • quantitynumber | nullобов’язкове
  • unitstring | nullобов’язкове
  • level"model" | "unit"обов’язкове
    model — bill of components of the model; unit — installed in this unit (assembly events)
  • sincestring | nullобов’язкове
    When the component was installed in this unit
• lifecycleobjectобов’язкове
  Lifecycle status of the passport: recalled — an active recall covers the code (a safety notice does not); end_of_life — the unit was recycled or became waste; archived — the brand left Itemoo and the passport is kept read-only; closed — the brand closed the passport after the product was placed on the market (the passport shows the state as of the closing date, since). A passport is never deleted: removal is a status (CIRPASS-2 D4.1 recommendation 3); a retired code answers 410
  ›Поля

  • status"active" | "recalled" | "end_of_life" | "archived" | "closed"обов’язкове
  • sincestring (date-time) | nullобов’язкове
• modelobjectобов’язкове
  Model passport fields visible at this level
• unitobject | nullобов’язкове
  ›Поля

  • serialstring | nullобов’язкове
  • dataobjectобов’язкове
  • stateobjectобов’язкове
    ›Поля

    • statusstring | nullобов’язкове
      original | repurposed | re-used | remanufactured | waste | recycled (Regulation (EU) 2023/1542 Annex XIII point 4(c); recycled ends the passport). null — not visible at this access level (a battery status is for persons with a legitimate interest only)
    • sohnumber | nullобов’язкове
      State of health, 0–100 (SoH, or SOCE / remaining capacity when only that is recorded)
    • sohAtstring (date-time) | nullобов’язкове
    • cyclesnumber | nullобов’язкове
    • incidentsintegerобов’язкове
  • historyobject[]обов’язкове
    ›Поля

    • kindstringобов’язкове
    • dataanyобов’язкове
    • occurredAtstring (date-time)обов’язкове
    • sourcestring
  • linksobjectобов’язкове
    ›Поля

    • predecessorobject | nullобов’язкове
      Passport before remanufacturing or repurposing (Art. 77(7))
      ›Поля

      • codestringобов’язкове
      • urlstringобов’язкове
    • successorsobject[]обов’язкове
      New passports created from this battery
      ›Поля

      • codestringобов’язкове
      • urlstringобов’язкове
  • custodianobject | nullобов’язкове
    Operator responsible for the passport of a waste battery after a transfer (producer, PRO or waste management operator — Art. 77(7))
    ›Поля

    • namestringобов’язкове
    • rolestringобов’язкове
    • sincestring (date-time)обов’язкове
• fieldsobjectобов’язкове
  Editable fields with their access levels, per layer
  ›Поля

  • modelmap<string, object>обов’язкове
    ›Поля

    • valueanyобов’язкове
    • access"public" | "legit" | "authority"обов’язкове
  • variantmap<string, object> | nullобов’язкове
    Variant layer (overrides the model)
    ›Поля

    • valueanyобов’язкове
    • access"public" | "legit" | "authority"обов’язкове
  • batchmap<string, object> | nullобов’язкове
    Batch layer (inherited by units)
    ›Поля

    • valueanyобов’язкове
    • access"public" | "legit" | "authority"обов’язкове
  • unitmap<string, object> | nullобов’язкове
    ›Поля

    • valueanyобов’язкове
    • access"public" | "legit" | "authority"обов’язкове
• unitMetaobject | nullобов’язкове
  Unit dates: code activation and placing on the market; predecessor passport code
  ›Поля

  • statusstringобов’язкове
  • activatedAtstring (date-time) | nullобов’язкове
  • placedOnMarketAtstring (date-time) | nullобов’язкове
  • predecessorCodestring | nullобов’язкове
• versionsany[]обов’язкове
  Version history of all layers with pseudonymous authors (see the public PassportHistory)
• chainmap<string, integer | null>обов’язкове
  Per layer: number of the first version whose hash does not verify, null = intact

Приклад

curl -X GET 'https://itemoo.eu/v1/passport/A1B2C3D4' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/passport/A1B2C3D4', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/A1B2C3D4');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/ld+json

object

• @contextstringобов’язкове
• idstringобов’язкове
• type"Product"обов’язкове
• passportobjectобов’язкове
  ›Поля

  • type"DigitalProductPassport"обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/v1/passport/A1B2C3D4/dpp.jsonld' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/passport/A1B2C3D4/dpp.jsonld', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/A1B2C3D4/dpp.jsonld');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

PassportHistory

• codestringобов’язкове
• level"public" | "legit" | "authority"обов’язкове
• versionPassportVersion | nullобов’язкове
  ›Поля · PassportVersion

  • hashstringобов’язкове
    SHA-256 of the canonical (RFC 8785) composition of layer versions and the unit event chain head
  • layersobject[]обов’язкове
    ›Поля

    • subject"product" | "variant" | "batch" | "unit"обов’язкове
    • versionintegerобов’язкове
    • hashstringобов’язкове
  • eventsHeadstring | nullобов’язкове
  • atstring (date-time)
    Present for a passport read at a point in time (?at=)
• versionsobject[]обов’язкове
  ›Поля

  • subject"product" | "variant" | "batch" | "unit"обов’язкове
  • versionintegerобов’язкове
  • hashstringобов’язкове
  • prevHashstring | nullобов’язкове
  • atstring (date-time)обов’язкове
  • sourcestringобов’язкове
  • changesobject[]обов’язкове
    ›Поля

    • keystringобов’язкове
    • op"add" | "change" | "remove"обов’язкове
    • valueany
    • redactedboolean
  • leavesmap<string, object>
    Leaf hashes (authority level only) to recompute the version hash
    ›Поля

    • hstringобов’язкове
    • access"public" | "legit" | "authority"обов’язкове

Приклад

curl -X GET 'https://itemoo.eu/v1/passport/A1B2C3D4/history' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/passport/A1B2C3D4/history', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/A1B2C3D4/history');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

object

• itemsobject[]обов’язкове
  ›Поля

  • @contextstringобов’язкове
  • idstringобов’язкове
• cursorstring | nullобов’язкове
  The cursor of the next page, null on the last one

Приклад

curl -X GET 'https://itemoo.eu/v1/passport/export' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/passport/export', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/export');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• fieldsmap<string, any | object>обов’язкове
  { key: value } or { key: { value, access } }; value null removes the field
  ›Поля

  • valueanyобов’язкове
  • access"public" | "legit" | "authority"

Відповідь 200 · application/json

object

• productIdstringобов’язкове
• skustring | nullобов’язкове
• fieldsmap<string, object>обов’язкове
  ›Поля

  • valueanyобов’язкове
  • access"public" | "legit" | "authority"обов’язкове

Приклад

curl -X PUT 'https://itemoo.eu/v1/passport/products/AKU-100' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"fields":{"chemistry":{"value":"LFP","access":"public"},"cathodeSupplier":"ACME"}}'

const res = await fetch('https://itemoo.eu/v1/passport/products/AKU-100', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "fields": {
      "chemistry": {
        "value": "LFP",
        "access": "public"
      },
      "cathodeSupplier": "ACME"
    }
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/products/AKU-100');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"fields":{"chemistry":{"value":"LFP","access":"public"},"cathodeSupplier":"ACME"}}',
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• itemsobject[]обов’язкове
  ›Поля

  • codestring
    Itemoo code of the unit — or sku + serial
  • skustring
  • serialstring
  • datamap<string, any | object>
    Unit fields; battery passport keys (battery.*) follow the field dictionary and have a fixed access level
    ›Поля

    • valueanyобов’язкове
    • access"public" | "legit" | "authority"
  • placedOnMarketAtstring | null
    Date the unit was placed on the market (YYYY-MM-DD), null clears it. A unit placed on the market after a field set takes effect must have a complete passport

Відповідь 200 · application/json

object

• receivedintegerобов’язкове
• savedintegerобов’язкове
• unknownstring[]обов’язкове
• errorsobject[]обов’язкове
  ›Поля

  • rowintegerобов’язкове
  • codestringобов’язкове

Приклад

curl -X PUT 'https://itemoo.eu/v1/passport/units' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"sku":"AKU-100","serial":"SN-0001","data":{"cellLot":"C-77"}}]}'

const res = await fetch('https://itemoo.eu/v1/passport/units', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "items": [
      {
        "sku": "AKU-100",
        "serial": "SN-0001",
        "data": {
          "cellLot": "C-77"
        }
      }
    ]
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/units');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"items":[{"sku":"AKU-100","serial":"SN-0001","data":{"cellLot":"C-77"}}]}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• kind"status" | "soh" | "cycles" | "incident" | "temperature" | "soc" | "data" | "assembly"обов’язкове
  assembly — component with its own passport installed or removed: data { action: install | remove, code (Itemoo code) or uri (https passport address), role? }
• dataobjectобов’язкове
• occurredAtstring (date-time)
  Not in the future; now by default
• access"public" | "legit" | "authority"
  public for status by default, legit otherwise

Відповідь 200 · application/json

object

• idstringобов’язкове
• codestringобов’язкове
• kindstringобов’язкове
• dataanyобов’язкове
• accessstringобов’язкове
• occurredAtstring (date-time)обов’язкове
• hashstring | nullобов’язкове
  SHA-256 of the event chained with the previous one (RFC 8785)

Приклад

curl -X POST 'https://itemoo.eu/v1/passport/units/U7K2M9QX/events' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"kind":"soh","data":{"soh":96}}'

const res = await fetch('https://itemoo.eu/v1/passport/units/U7K2M9QX/events', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "kind": "soh",
    "data": {
      "soh": 96
    }
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/passport/units/U7K2M9QX/events');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"kind":"soh","data":{"soh":96}}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

object

Приклад

curl -X GET 'https://itemoo.eu/v1/drafts/products/KAW-250/page' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/drafts/products/KAW-250/page', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/products/KAW-250/page');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Тіло запиту application/json

• draftRevisionstringобов’язкове
  draftRevision from the last read; if the draft changed since, the call fails with draftConflict — read again
• operationsobject[]обов’язкове
  Operations applied in order; indexes refer to the page after the previous operations
• dryRunboolean
  Default true: nothing is saved — the result shows what would change and a planToken. Ask the user, then call again with the SAME arguments, dryRun: false and that planToken.
• planTokenstring
  planToken from the preview of exactly these arguments (required with dryRun: false, valid 10 minutes)

Відповідь 200 · application/json

object

Приклад

curl -X PUT 'https://itemoo.eu/v1/drafts/products/KAW-250/page' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"draftRevision":"0123456789abcdef","operations":[{"op":"set","path":"2.lead","value":"Medium roast, notes of cocoa."}],"dryRun":true}'

const res = await fetch('https://itemoo.eu/v1/drafts/products/KAW-250/page', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "draftRevision": "0123456789abcdef",
    "operations": [
      {
        "op": "set",
        "path": "2.lead",
        "value": "Medium roast, notes of cocoa."
      }
    ],
    "dryRun": true
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/products/KAW-250/page');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"draftRevision":"0123456789abcdef","operations":[{"op":"set","path":"2.lead","value":"Medium roast, notes of cocoa."}],"dryRun":true}',
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• productsobject[]обов’язкове
  ›Поля

  • namestringобов’язкове
    Product name
  • skustringобов’язкове
    SKU — unique in the brand
  • categorystringобов’язкове
    Product category key (e.g. "chemicals")
  • gtinstring
    GTIN / EAN (8–14 digits)
  • operationsobject[]
    Optional text operations on the starting page (as in product_page_draft_patch)
• langstring
  Language of the texts (two letters); default: the brand default language. Texts in other languages are marked as machine-written for review
• dryRunboolean
  Default true: nothing is saved — the result shows what would change and a planToken. Ask the user, then call again with the SAME arguments, dryRun: false and that planToken.
• planTokenstring
  planToken from the preview of exactly these arguments (required with dryRun: false, valid 10 minutes)

Відповідь 200 · application/json

object

Приклад

curl -X POST 'https://itemoo.eu/v1/drafts/products' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"products":[{"name":"Coffee 250 g","sku":"KAW-250","category":"food"}],"dryRun":true}'

const res = await fetch('https://itemoo.eu/v1/drafts/products', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "products": [
      {
        "name": "Coffee 250 g",
        "sku": "KAW-250",
        "category": "food"
      }
    ],
    "dryRun": true
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/products');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"products":[{"name":"Coffee 250 g","sku":"KAW-250","category":"food"}],"dryRun":true}',
]);
$data = json_decode(curl_exec($ch), true);

Відповідь 200 · application/json

object

Приклад

curl -X GET 'https://itemoo.eu/v1/drafts/site' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/drafts/site', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/site');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• draftRevisionstringобов’язкове
  draftRevision from the last read; if the draft changed since, the call fails with draftConflict — read again
• operationsobject[]обов’язкове
  Operations applied in order; only theme, pages, navigation and seo, never legal pages or legal links
• dryRunboolean
  Default true: nothing is saved — the result shows what would change and a planToken. Ask the user, then call again with the SAME arguments, dryRun: false and that planToken.
• planTokenstring
  planToken from the preview of exactly these arguments (required with dryRun: false, valid 10 minutes)

Відповідь 200 · application/json

object

Приклад

curl -X PUT 'https://itemoo.eu/v1/drafts/site' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"draftRevision":"0123456789abcdef","operations":[{"op":"set","path":"seo.description","value":"Coffee roasted in Krakow."}],"dryRun":true}'

const res = await fetch('https://itemoo.eu/v1/drafts/site', {
  method: 'PUT',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "draftRevision": "0123456789abcdef",
    "operations": [
      {
        "op": "set",
        "path": "seo.description",
        "value": "Coffee roasted in Krakow."
      }
    ],
    "dryRun": true
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/site');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"draftRevision":"0123456789abcdef","operations":[{"op":"set","path":"seo.description","value":"Coffee roasted in Krakow."}],"dryRun":true}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

object

Приклад

curl -X GET 'https://itemoo.eu/v1/drafts/publications/post-ai-x7Kp2' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/drafts/publications/post-ai-x7Kp2', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/publications/post-ai-x7Kp2');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• idstring
  Existing post id (edit); omit to create
• draftRevisionstring
  draftRevision from the last read; if the draft changed since, the call fails with draftConflict — read again
• titlestringобов’язкове
  Working name in the calendar
• messagestringобов’язкове
  Main message of the post
• headlinestring
  Text on the graphic
• template"product" | "teaser" | "free"
  Graphic template; default: product when products are given, otherwise free
• productCodesstring[]
  Itemoo codes of the products in the post
• scheduledAtstring (date-time)
  Planned publication time (ISO 8601)
• variantsobject[]
  ›Поля

  • platform"facebook" | "instagram" | "linkedin" | "tiktok"обов’язкове
  • textstringобов’язкове
    Post text for this platform
  • hashtagsstring[]
  • altTextstring
    Alternative text of the graphic
• dryRunboolean
  Default true: nothing is saved — the result shows what would change and a planToken. Ask the user, then call again with the SAME arguments, dryRun: false and that planToken.
• planTokenstring
  planToken from the preview of exactly these arguments (required with dryRun: false, valid 10 minutes)

Відповідь 200 · application/json

object

Приклад

curl -X POST 'https://itemoo.eu/v1/drafts/publications' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"New roast","message":"Our new medium roast is here.","dryRun":true}'

const res = await fetch('https://itemoo.eu/v1/drafts/publications', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "title": "New roast",
    "message": "Our new medium roast is here.",
    "dryRun": true
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/publications');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"title":"New roast","message":"Our new medium roast is here.","dryRun":true}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

object

Приклад

curl -X GET 'https://itemoo.eu/v1/drafts/articles/clx0article' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/drafts/articles/clx0article', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/articles/clx0article');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• idstring
  Existing draft article id; omit to create
• draftRevisionstring
  draftRevision from the last read; if the draft changed since, the call fails with draftConflict — read again
• langstring
  Language of the texts (two letters); default: the brand default language. Texts in other languages are marked as machine-written for review
• titlestring
  Title
• excerptstring
  Short summary
• bodystring
  Body: paragraphs separated by an empty line, "## " for subheadings
• categorystring
• slugstring
• productCodesstring[]
• dryRunboolean
  Default true: nothing is saved — the result shows what would change and a planToken. Ask the user, then call again with the SAME arguments, dryRun: false and that planToken.
• planTokenstring
  planToken from the preview of exactly these arguments (required with dryRun: false, valid 10 minutes)

Відповідь 200 · application/json

object

Приклад

curl -X POST 'https://itemoo.eu/v1/drafts/articles' \
  -H 'Authorization: Bearer itm_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"How to brew","body":"Use 15 g of coffee per 250 ml of water.","dryRun":true}'

const res = await fetch('https://itemoo.eu/v1/drafts/articles', {
  method: 'POST',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({
    "title": "How to brew",
    "body": "Use 15 g of coffee per 250 ml of water.",
    "dryRun": true
  }),
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/articles');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => '{"title":"How to brew","body":"Use 15 g of coffee per 250 ml of water.","dryRun":true}',
]);
$data = json_decode(curl_exec($ch), true);

Параметри

Відповідь 200 · application/json

object

Приклад

curl -X GET 'https://itemoo.eu/v1/drafts/campaigns/clx0campaign' \
  -H 'Authorization: Bearer itm_YOUR_KEY'

const res = await fetch('https://itemoo.eu/v1/drafts/campaigns/clx0campaign', {
  method: 'GET',
  headers: { Authorization: 'Bearer ' + process.env.ITEMOO_API_KEY },
});
const data = await res.json();

$ch = curl_init('https://itemoo.eu/v1/drafts/campaigns/clx0campaign');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('ITEMOO_API_KEY')],
]);
$data = json_decode(curl_exec($ch), true);

Тіло запиту application/json

• idstring
  Existing draft campaign id; omit to create
• draftRevisionstring
  draftRevision from the last read; if the draft changed since, the call fails with draftConflict — read again
• langstring
  Language of the texts (two letters); default: the brand default language. Texts in other languages are marked as machine-written for review
• namestring
  Internal name
• titlestring
  Notification title
• bodystring
  Notification text
• targetobject
  Where the button leads; default: the brand app
  ›Поля

  • type"app" | "product" | "group"обов’язкове
  • codestring
    Product code for type "product"
  • groupstring
    Shop category for type "group"
• countriesstring[]
• productCodesstring[]
  Only people who scanned these products; empty = everyone with consent
• pushboolean
• emailboolean
• dryRunboolean
  Default true: nothing is saved — the result shows what would change and a planToken. Ask the user, then call again with the SAME arguments, dryRun: false and that planToken.
• planTokenstring
  planToken from the preview of exactly these arguments (required with dryRun: false, valid 10 minutes)