Willowcommerce API

Integrate orders, shipments, tracking, rates, and labels into your systems.

v1.0.0

Livehttps://api.willowcommerce.com/v1

Testhttps://testapi.willowcommerce.com/v1

Authentication

All API requests (except health check) require an API key. Include it in the X-API-Key header:

# Live environment
curl -H "X-API-Key: gbc_live_abc123..." \
  https://api.willowcommerce.com/v1/orders

# Test environment
curl -H "X-API-Key: gbc_test_abc123..." \
  https://testapi.willowcommerce.com/v1/orders

Generate API keys in your dashboard under Company → API Keys. Each key is scoped to your company and can have specific permissions.

Rate Limits

Default rate limits per API key:

60 requests/minute (configurable per key)
10,000 requests/day (configurable per key)

When rate limited, the response includes a retry_after value in seconds.

Pagination

List endpoints support pagination:

GET /v1/orders?page=1&limit=50

// Response includes meta:
{
  "meta": {
    "page": 1,
    "limit": 50,
    "total": 250,
    "total_pages": 5
  }
}

Maximum limit is 200 per request.

Bulk Operations

Several endpoints support bulk operations:

POST /v1/orders — Up to 500 orders per request
POST /v1/rates — Up to 100 rate requests per call
POST /v1/labels — Up to 50 labels per call

Bulk responses return a 207 status for partial success, with individual results for each item.

Response Headers

Every response includes:

X-Request-Id — Unique request ID for debugging
X-Latency-Ms — Server processing time