Get Booking Categories

Booking Management Helper

Retrieve the list of available shipment categories. This is a prerequisite for creating a booking, as you need to provide a valid category ID in the booking payload.

Verb

GET · stateless

Usage

Call before Create Booking

Endpoint

GET Categories

{{base_url}}/partner/booking/get-categories

---

cURL Example

curl -X GET "https://booking.aajexpress.org/api/v2/partner/booking/get-categories" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

---

Response payload

{
  "success": true,
  "data": {
    "payload": [
      {
        "_id": "68526c5288d9322dd836f828",
        "name": "Electronics",
        "percentageValue": {
          "$numberDecimal": "0"
        },
        "securityHandlingFee": 400,
        "description": "Ship packages containing electronic items safely and securely."
      },
      {
        "_id": "68c2a70190f1fdaabd8c0b8e",
        "name": "Non Electronics",
        "percentageValue": {
          "$numberDecimal": "0"
        },
        "securityHandlingFee": 0,
        "description": "Ship packages that do not contain electronic items."
      }
    ]
  },
  "status": 200,
  "message": "success!",
  "timestamp": "2025-12-04T19:37:07.247Z"
}

Response fields

Field	Description
_id	The unique identifier for the category. Use this in the create-booking payload.
name	The human-readable name of the category (e.g., "Electronics").
securityHandlingFee	Additional fee applied for this category.
description	Details about what items fall under this category.