Shipment Tracking API

curl -X GET 'https://api-commerce.nucleoplatform.com/api/oms/v1/public/tracking/MTA0Mjo3ZjNjMmE5MS00YjZkLTRlMmEtOWMxZi0zZDhlNWEyYjZjNDA.Qm9Yc1Z3Tm1LcFJ0WmFHaEpk?lang=it' \
  -H 'Accept: application/json'

const res = await fetch("https://api-commerce.nucleoplatform.com/api/oms/v1/public/tracking/MTA0Mjo3ZjNjMmE5MS00YjZkLTRlMmEtOWMxZi0zZDhlNWEyYjZjNDA.Qm9Yc1Z3Tm1LcFJ0WmFHaEpk?lang=it", {
  method: "GET",
  headers: {
    Accept: "application/json",
  },
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-commerce.nucleoplatform.com/api/oms/v1/public/tracking/MTA0Mjo3ZjNjMmE5MS00YjZkLTRlMmEtOWMxZi0zZDhlNWEyYjZjNDA.Qm9Yc1Z3Tm1LcFJ0WmFHaEpk?lang=it', [
    'headers' => [
        'Accept' => 'application/json',
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

{
  "data": {
    "brand": {
      "name": "Acme Apparel",
      "logo_url": "https://cdn.acme.example/logo.svg",
      "accent_color": "#0F766E",
      "support_email": "help@example.com",
      "support_url": "https://shop.acme.example/pages/contact"
    },
    "locale": "it",
    "order_name": "#1042",
    "customer_first_name": "Giulia",
    "destination": "Milano, IT",
    "carrier": "DHL Express",
    "tracking_numbers": [
      "1234567890"
    ],
    "carrier_url": "https://www.dhl.com/it-en/home/tracking.html?tracking-id=1234567890",
    "status": "out_for_delivery",
    "status_at": "2026-10-06T07:42:00+00:00",
    "shipped_at": "2026-10-05T15:10:00+00:00",
    "delivered_at": null,
    "estimated_delivery_at": "2026-10-06T18:00:00+00:00",
    "items": [
      {
        "title": "Organic Cotton Tee · M",
        "quantity": 1
      },
      {
        "title": "Fleece Hoodie · L",
        "quantity": 2
      }
    ],
    "events": [
      {
        "occurred_at": "2026-10-06T07:42:00+00:00",
        "status": "out_for_delivery",
        "description": "Shipment is out with courier for delivery",
        "location": "Milano, IT"
      },
      {
        "occurred_at": "2026-10-05T21:03:00+00:00",
        "status": "in_transit",
        "description": "Processed at MILANO - ITALY",
        "location": "Milano, IT"
      },
      {
        "occurred_at": "2026-10-05T15:10:00+00:00",
        "status": "picked_up",
        "description": "Shipment picked up",
        "location": "Bologna, IT"
      }
    ]
  }
}

{
  "error": "not_found"
}

{
  "message": "Too Many Attempts."
}

curl -X POST https://api-commerce.nucleoplatform.com/api/oms/v1/webhooks/tracking/5f0c7e2a-8b3d-4c1e-9a6f-2d4b8e1c7a35 \
  -H "X-Nucleo-Signature: $NUCLEO_SIGNATURE" \
  -H 'Content-Type: application/json' \
  -d '{
  "events": [
    {
      "tracking_number": "0612345678901",
      "status": "",
      "description": "Consegnata al destinatario",
      "occurred_at": "2026-10-06T11:05:00Z",
      "location": "Milano"
    },
    {
      "tracking_number": "0612345678902",
      "status": "exception",
      "exception_code": "recipient_absent",
      "description": "Recipient not at home, second attempt tomorrow",
      "occurred_at": "2026-10-06T11:20:00Z",
      "location": "Torino"
    }
  ]
}'

const res = await fetch("https://api-commerce.nucleoplatform.com/api/oms/v1/webhooks/tracking/5f0c7e2a-8b3d-4c1e-9a6f-2d4b8e1c7a35", {
  method: "POST",
  headers: {
    "X-Nucleo-Signature": `${process.env.NUCLEO_SIGNATURE}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "events": [
      {
        "tracking_number": "0612345678901",
        "status": "",
        "description": "Consegnata al destinatario",
        "occurred_at": "2026-10-06T11:05:00Z",
        "location": "Milano"
      },
      {
        "tracking_number": "0612345678902",
        "status": "exception",
        "exception_code": "recipient_absent",
        "description": "Recipient not at home, second attempt tomorrow",
        "occurred_at": "2026-10-06T11:20:00Z",
        "location": "Torino"
      }
    ]
  }),
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('POST', 'https://api-commerce.nucleoplatform.com/api/oms/v1/webhooks/tracking/5f0c7e2a-8b3d-4c1e-9a6f-2d4b8e1c7a35', [
    'headers' => [
        'X-Nucleo-Signature' => getenv('NUCLEO_SIGNATURE'),
    ],
    'json' => [
        'events' => [
            [
                'tracking_number' => '0612345678901',
                'status' => '',
                'description' => 'Consegnata al destinatario',
                'occurred_at' => '2026-10-06T11:05:00Z',
                'location' => 'Milano',
            ],
            [
                'tracking_number' => '0612345678902',
                'status' => 'exception',
                'exception_code' => 'recipient_absent',
                'description' => 'Recipient not at home, second attempt tomorrow',
                'occurred_at' => '2026-10-06T11:20:00Z',
                'location' => 'Torino',
            ],
        ],
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

{
  "result": "OK",
  "applied": 2
}

{
  "result": "KO",
  "error": "invalid json"
}

{
  "result": "KO",
  "error": "unauthorized"
}

{
  "result": "KO",
  "error": "unknown connection"
}

{
  "message": "Too Many Attempts."
}