Developer
Log in

GHNDeveloper

Connect your systems
with the GHN delivery network

Complete documentation, standard REST endpoints and a dedicated sandbox — everything you need to bring GHN shipping into your system.

Create your first order with the GHN API

200 · Order created successfully

{
  "code": 200,
  "message": "Success",
  "data": {
    "order_code": "5F9NL3RH",
    "total_fee": 22000,
    "expected_delivery_time": "2026-07-17T23:59:59+07:00"
  }
}
Create ordersCalculate feesEstimated delivery timeTrack ordersPrint waybillsCOD reconciliationRealtime webhooks3-level addressPost offices & warehousesSupport ticketsReturnsPickup shifts

Overview

API catalog

Public REST/JSON APIs, grouped by each shipping business domain.

Getting StartedOverview and how to get a token to make your first request to GHN.
TokenCreate an account and get your authentication token.
OrdersThe full order lifecycle: create, update, cancel, print labels, fees and tracking.
Master DataStandardized provinces, districts, wards, stations, services and pickup shifts.
ShopsManage the shops / pickup warehouses linked to your account.
WebhooksReceive realtime order and ticket status via a callback URL.
TicketsCreate and track shipment support requests from your own system.
AffiliateCreate shops and staff on behalf of customers via the OTP flow.

Order APIs

Manage the full order lifecycle

Create, update, cancel, redeliver, print labels, and track status. Each action is a dedicated endpoint with fully documented parameters and responses.

Fees & Services APIs

Calculate fees and estimated delivery time

Calculate shipping fees by route, weight, and service package, with a lead time API to show delivery details before creating an order.

Webhook

Receive order status via webhook

Register a callback URL once and GHN pushes order status changes and COD cash flow to your system in real time, no polling required.

Quick start

Integrate in 4 steps

Follow the 4 steps below to push real orders to GHN.

  1. 01

    Create an account

    Sign up for free at khachhang.ghn.vn (or the staging environment 5sao.ghn.dev).

  2. 02

    Get your token & ShopId

    Open your account settings to obtain the API token and shop ID.

  3. 03

    Try it on the staging environment

    Create orders and calculate fees with mock data — no real orders are generated.

  4. 04

    Go live

    Switch the endpoint to production and start pushing real orders to GHN.