Webhook

Whenever the status of your shipment changes, Starex sends a notification to your server automatically.

1. General

When a shipment status changes, Starex sends an HTTP POST request to the URL you provided. The request carries the shipment barcode, the new status code and the status timestamp.

To connect, you give Starex your webhook URL (for example https://your-domain.uz/starex/webhook) — after that you only receive notifications for your own shipments.

2. Request

POST {YOUR_WEBHOOK_URL}
Content-Type: application/json

{
  "barcode": "AB123456789UZ",
  "state": 9,
  "statetime": "2026-06-15 14:30:00",
  "description": "Delivered to the recipient"
}

Field	Type	Description
`barcode`	string	Shipment barcode (the same `order_code` returned when the order was created)
`state`	integer	New status code
`statetime`	string	Status change timestamp, `YYYY-MM-DD HH:MM:SS`
`description`	string\|null	Additional comment for the status

The meaning of state codes is in the status dictionary (GET /api/v2/dictionaries/states). Additional shipment details are available through the trace request by barcode.

3. Response

To confirm receipt, return HTTP 200. The response body does not matter.

Your response	Result
`200`	Considered delivered
Any other code (`2xx`, `3xx`, `4xx`, `5xx`)	Failure — will be sent again
No response within 5 seconds	Failure — will be sent again

The request timeout is 5 seconds.
On failure the notification is retried up to 5 times, after which it is no longer sent.
Because of retries the same status may arrive more than once; a duplicate can be identified by barcode + state + statetime.