Decathlon API v1 Documentation

The Decathlon API v1 allows partners to create shipment packages and retrieve package tracking history programmatically using JSON over HTTPS.

Base URL

https://decathlon-api.aaf-express.com/

Authentication

Secret API Key (passed in URL)
Valid account_number (passed in request body)

Create Package

POST

/v1/{SECRET_KEY}/package-create

Headers

Content-Type: application/json

Account Information

Field	Type	Required	Description
account_number	string	Yes	Customer account number
special_instruction	string	No	HS Code, COO, notes
payment_type	string	No	prepaid / collect
package_description	string	No	Package description

Package Dimensions

Field	Type	Required	Description
order_length	float	Yes	Length
order_width	float	Yes	Width
order_height	float	Yes	Height
order_weight	string	Yes	Weight in KG

Items

Field	Type	Required	Description
item_desc	string	Yes	Item description
item_category	string	No	Category
item_product_id	int	No	Product ID
item_sku	string	No	SKU
item_quantity	int	Yes	Quantity
item_price_value	string	Yes	Declared value
item_price_currency	string	No	Currency (USD default)

Automatically computed:
• total_qty = sum of item quantities
• total_declared_val = price × quantity

Sample Request

{
  "account_number": "test12345",
  "special_instruction": "HS Code: 640391900, Country Of Origin: VN",
  "order_length": 14.0,
  "order_width": 10.0,
  "order_height": 6.0,
  "order_weight": "1.361",
  "items": [
    {
      "item_desc": "Fashion Footwear",
      "item_quantity": 1,
      "item_price_value": "248.0"
    }
  ],
  "consignee_name": "Monarch Diversified Logistics Inc",
  "consignee_city": "Paranaque",
  "consignee_country": "Philippines",
  "pickup_contact_name": "XXX",
  "pickup_city": "Paranaque",
  "pickup_country": "Philippines"
}

{
  "status": "success",
  "message": "Package created successfully",
  "tracking_number": "AAF240201000112"
}

Package History

POST

/v1/{SECRET_KEY}/package-history

Request

{
  "tracking_number": "AAF240201000112"
}

Response

{
  "status": "success",
  "data": {
    "package": {
      "tracking_number": "AAF240201000112",
      "package_weight": "1.361",
      "actual_package_weight": "1.361"
    },
    "history": [
      {
        "date_added": "2026-02-01 10:30:00",
        "status": "Package Created",
        "remarks": "Package Created"
      }
    ]
  }
}

Error Responses

{ "status": "error", "message": "Invalid API key" }