wOow Global API Documentation

Welcome to the wOow Global API - your complete solution for shipping and logistics operations. Build powerful applications that integrate seamlessly with our comprehensive shipping platform.

What You Can Build

E-commerce Integration: Calculate real-time shipping rates and create orders
Order Management: Create and manage order lifecycles
Label Generation: Automatically generate shipping labels and packing lists
Category Management: Organize products with smart categorization

⚡ Quick Start

1. Get Your API Token

Visit the Developer Dashboard to obtain your API token for sandbox testing.

2. Choose Your Environment

Sandbox (Testing):

https://dev-api.woowbd.com

Production:

https://api.woowbd.com

3. Make Your First Request

curl -X GET "https://api.woowbd.com/categories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

4. Calculate Shipping Rates

curl -X POST "https://api.woowbd.com/get-shipping-rates" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "box_dimension": [
      {
        "length": 10,
        "width": 8,
        "height": 6,
        "weight": 2.5,
        "items": [
          {
            "name": "Sample Product",
            "quantity": "2",
            "unit_price": "29.99"
          }
        ]
      }
    ],
    "product_type": "1",
    "weight": 2.5,
    "weight_unit": "LBS",
    "sender": {
      "state": "New York",
      "state_short_code": "NY",
      "city": "New York",
      "zip_code": "10001",
      "country_code": "US"
    },
    "receiver": {
      "state": "California",
      "state_short_code": "CA",
      "city": "Los Angeles",
      "zip_code": "90210",
      "country_code": "US"
    },
    "delivery_type": "commercial"
  }'

API Reference

Core Endpoints

Shipping Rates

Calculate shipping costs with multiple courier options.

POST/get-shipping-rates

Calculate shipping rates with package details

View Shipping Rates Documentation

Orders

Complete order lifecycle management.

POST/create-order

Create a new order with rate ID

GET/orders

List all orders (paginated)

GET/orders/{tracking_number}

Get order details

DELETE/orders/cancel/{tracking_number}

Cancel an order

View Orders Documentation

Labels

Retrieve shipping labels and packing lists.

GET/labels/{tracking_number}

Get shipping label and packing list

View Labels Documentation

Authentication

All API requests require authentication using Bearer tokens in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Security Best Practices:

• Always use HTTPS for production requests
• Keep your API keys secure and never expose them in client-side code
• Rotate keys regularly
• Use environment variables to store keys

Response Format

All API responses follow a consistent JSON format:

{
  "status": true,
  "message": "Success message",
  "data": {
    // Response data
  },
  "errors": [],
  "response_code": "200"
}

Error Handling

API errors return appropriate HTTP status codes and detailed error information:

{
  "status": false,
  "message": "Error message",
  "data": [],
  "errors": [
    "Detailed error information"
  ],
  "response_code": "400"
}

📋 Common HTTP Status Codes:

200 - Success

400 - Bad Request

401 - Unauthorized

403 - Forbidden

404 - Not Found

429 - Rate Limit

500 - Server Error

SDKs & Libraries

We're working on official SDKs for popular programming languages. For now, you can use our REST API with any HTTP client.

🚀 Coming Soon:

JavaScript/TypeScript SDK

Python SDK

PHP SDK

Ruby SDK

Support

📚 Documentation

Browse our comprehensive guides

Ready to get started?

Set up your environment →

API Documentation