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 URL: https://api.gearment.com/integration-handler
Sandbox API URL: https://api.gearmentinc.com/integration-handler
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:
https://apiv2.gearment.com/integration-handler/
https://api.gearmentinc.com/integration-handler/