Tracking API

Show your customers where their package is. Fetch the same tracking timeline and proof of delivery you see in your panel.

GET/tracking/{tracking_number}

Track by tracking number

Get the full tracking timeline using the 4N NextDay tracking number.

Path Parameters

Name
tracking_number
Type
string
Description
The order tracking number (e.g., 4N000000012345). Required.

Response Fields

Name
tracking_number
Type
string
Description
The order tracking number.
Name
external_reference
Type
string
Description
Your custom reference for the order.
Name
delivery_state
Type
string
Description
Current delivery state.
Name
estimated_delivery_date
Type
string
Description
Expected delivery date.
Name
delivery_date
Type
string
Description
Actual delivery date (if delivered).
Name
timeline
Type
array
Description
Array of tracking events in chronological order.
Name
delivery_proof
Type
object
Description
Proof of delivery information (only for delivered orders).

GET

/tracking/{tracking_number}

curl https://api.4nortes.app/api/v1/tracking/4N000000012345 \
  -H "Authorization: Bearer {token}"

Response

{
  "success": true,
  "message": "Tracking retrieved successfully",
  "data": {
    "tracking_number": "4N000000012345",
    "external_reference": "ORDER-001",
    "delivery_state": "delivered",
    "estimated_delivery_date": "2025-02-05",
    "delivery_date": "2025-02-04",
    "recipient_name": "Jane Doe",
    "destination": {
      "locality": "Providencia"
    },
    "timeline": [
      {
        "state": "pending",
        "timestamp": "2025-02-03T10:00:00.000000Z",
        "type": "state_change",
        "failure_info": null
      },
      {
        "state": "picked_up",
        "timestamp": "2025-02-03T14:30:00.000000Z",
        "type": "state_change",
        "failure_info": null
      },
      {
        "state": "in_transit",
        "timestamp": "2025-02-03T18:00:00.000000Z",
        "type": "state_change",
        "failure_info": null
      },
      {
        "state": "out_for_delivery",
        "timestamp": "2025-02-04T08:00:00.000000Z",
        "type": "state_change",
        "failure_info": null
      },
      {
        "state": "delivered",
        "timestamp": "2025-02-04T11:30:00.000000Z",
        "type": "state_change",
        "failure_info": null
      }
    ],
    "delivery_proof": {
      "recipient_name": "Jane Doe",
      "recipient_rut": "12345678-9",
      "recipient_role": "recipient",
      "notes": null,
      "location": {
        "latitude": -33.4289,
        "longitude": -70.6093
      },
      "photos": [
        {
          "url": "https://storage.example.com/photos/abc123.jpg",
          "preview_url": "https://storage.example.com/photos/thumb/abc123.jpg"
        }
      ],
      "delivered_at": "2025-02-04T11:30:00.000000Z"
    }
  },
  "timestamp": "2025-02-04T12:00:00.000000Z"
}