Glossary

Cross-border logistics has its own jargon. This page defines the terms you'll see across these docs.

Air & freight

MAWB — Master Air Waybill. The single contract between the freight forwarder and the airline for an entire shipment of consolidated packages on a flight. One MAWB groups many HAWBs.

HAWB — House Air Waybill. The per-package contract issued by the freight forwarder to the end consignee. In LogirAI, one guide maps to one HAWB.

ETA — Estimated time of arrival at the destination airport.

Consignee — The recipient of the package (the end customer).

LogirAI domain

Pre-alert — The advance notification you send LogirAI before a shipment lands so customs and final-mile can prepare. Submitted via POST /api/public/pre-alerts/v1/upload.

Manifest — The Excel document inside a pre-alert that lists every HAWB in the shipment. After processing, it becomes a manifest record in LogirAI with its own manifest_id.

Guide — A single trackable package. Maps 1:1 to a HAWB. Has a status, a consignee, and a timeline of events.

Tracking code — LogirAI-issued identifier for a guide (e.g. LR2026A1B2C3). This is the lookup key for GET /api/public/pre-alerts/v1/guides/:tracking_code.

Status / status_code — Numeric and string representation of a guide's current state. Range 1–6 on the happy path. See the status reference.

Tracking event — A timestamped state transition on a guide (registered → in_transit → customs_released → out_for_delivery → delivered).

Webhooks

Webhook delivery — Outbound HTTP POST from LogirAI to your endpoint with MAWB or HAWB lifecycle events. Bearer-secret authenticated.

Bearer secret — Shared secret you provision with LogirAI for authenticating webhook deliveries.

Identifier prefixes

Prefix	Meaning
evt_	Webhook event ID — also surfaced as X-Logir-Delivery-Id.
LR	LogirAI-issued tracking code.