RESTful API with predictable resource-oriented URLs. JSON-encoded requests and responses. Standard HTTP codes and authentication.
Authenticate requests by including your API key in the Authorization header. Keep your keys secure and never expose them in client-side code.
curl https://api.merchos.io/v2/orders \
-H "Authorization: Bearer sk_live_xxxxx"/v2/orders/v2/orders/:id/v2/orders/v2/orders/:id/v2/orders/:id/v2/inventory/v2/inventory/:sku/v2/inventory/adjust/v2/inventory/transfer/v2/webhooks/v2/webhooks/v2/webhooks/:idcurl -X POST https://api.merchos.io/v2/orders \
-H "Authorization: Bearer sk_live_xxxxx" \
-H "Content-Type: application/json" \
-d '{
"customer": {
"email": "customer@example.com",
"shipping_address": {
"line1": "123 Main St",
"city": "San Francisco",
"state": "CA",
"postal_code": "94102",
"country": "US"
}
},
"items": [
{
"sku": "TSHIRT-BLK-L",
"quantity": 2
}
]
}'{
"id": "ord_1234567890",
"status": "processing",
"created_at": "2024-01-15T10:30:00Z",
"fulfillment_center": "LAX-01",
"estimated_delivery": "2024-01-18",
"tracking": {
"carrier": "USPS",
"number": null,
"url": null
},
"webhook_url": "https://your-site.com/webhooks"
}// Webhook payload for order.shipped event
{
"event": "order.shipped",
"timestamp": "2024-01-16T14:22:00Z",
"data": {
"order_id": "ord_1234567890",
"tracking_number": "9400111899223456789012",
"carrier": "USPS",
"tracking_url": "https://tools.usps.com/...",
"estimated_delivery": "2024-01-18"
}
}Rate limits are applied per API key. Headers indicate your current usage and reset time.
X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 847 X-RateLimit-Reset: 1705320000
Get your API keys and start integrating in minutes. Full documentation and support available.