Welcome to the Gearment Print-On-Demand (POD) Seller API! This API enables seamless integration between your stores, applications, and the Gearment platform. With our API, you can:
Manage products and variants
Sync inventory
Create and manage orders
Track fulfillment status
This documentation will guide you through authentication, rate limits, and how to start using the API.
Production API v3 URL: https://apiv2.gearment.com/integration-handler
Sandbox API v3 URL: https://api.gearmentinc.com/integration-handler
Need to use API v2
👉 View API v2 Documentation here
All API requests must be authenticated with an API Key. Unauthorized requests will be rejected.
How to obtain your API Key
⚠️ Important: Keep your API key secure. Do not share it publicly or embed it directly in client-side applications. If your API Key is compromised, immediately revoke it and generate a new one.
Include your API key in the request headers:
X-Gearment-Client-Key: Your_Gearment_Client_Key
X-Gearment-Client-Secret: Your_Gearment_Client_Secret"
To ensure stable service for all users, the Gearment API enforces rate limiting.
| Rate Limit Type | Value |
|---|---|
| Requests | 100 requests per 10 seconds, Block for 1 minute |
| Retry-After | If exceeded, Retry-After header will indicate when you can retry |
If you exceed the rate limit, the API will respond with:
json{
"error": {
"code": 429,
"message": "Rate limit exceeded. Please retry later."
}
}Best Practices:
🚀 Migration Guide: Moving from v1/v2 to Next App v3 API/Webhook
Good news:
✅ Backward compatibility is preserved.
Your existing integrations using API v1/v2 and Webhook v1/v2 will continue to work out of the box without changes.
✅ You can switch to the new APIs at your own pace.
1. What stays the same
2. API Endpoints Overview
| Version | Base URL | Sandbox | Notes |
|---|---|---|---|
| v1/v2 | https://api.gearment.com | N/A | v1/v2 API, still supported via compatibility layer |
| v3 | https://apiv2.gearment.com/integration-handler | https://api.gearmentinc.com/integration-handler | Next App API (new API features) |
3. What’s new in API v3
Example API v3 Request:
curl -i -X GET \
-H "X-Gearment-Client-Key: xxx" \
-H "X-Gearment-Client-Secret: xxxxxx" \
'https://apiv2.gearment.com/integration-handler/api/v3/catalog/variants/stock?filter.product_ids=G5000&filter.variant_ids=GM0002003147&filter.variant_id=GM0002005986&filter.sizes=3XL&filter.color_codes=daisy&filter.stock_labels=VENDOR_CATALOG_VARIANT_STOCK_LABEL_IN_STOCK&paging.page=1&paging.limit=100'4. Webhooks in v3 Modified payload for webhooks
👉 Configure your webhooks in the Developer Settings.
Example Shipping Address Verified Webhook Payload:
{
"type": "shipping_address_verified",
"data": {
"gearment_ord_id": "ORD123456789",
"gearment_ord_name": "#10001",
"ord_status": "pending",
"verify_address": "verified",
"order_id": "EXT-1234567"
}
}{
"type": "shipping_address_verified",
"order": {
"gearment_id": "ORD123456789",
"gearment_name": "#10001",
"vendor_id": "EXT-1234567",
"verify_address": "verified",
"ord_status": "pending"
}
}5. Migration Path If you’re ready to explore API v3, follow these steps:
6. Recommendations
7. Support Need help migrating?
https://apiv2.gearment.com/integration-handler/
https://api.gearmentinc.com/integration-handler/
VendorWebhookAPI provides webhook management for real-time event notifications. Register webhooks to receive automated notifications when orders are completed, cancelled, or tracking is updated.
Base URL: https://apiv2.gearment.com/integration-handler Authentication: API Key (header: X-API-Key, X-API-Secret)
VendorCatalogAPI provides access to product catalog and inventory management. Use these endpoints to browse available products, check stock status, and get product details.
Base URL: https://apiv2.gearment.com/integration-handler Authentication: API Key (header: X-API-Key, X-API-Secret)