v2
latestOpenAPI 3.1.02026-07-26102336742.6 KBExternal Orders
Validate external order
Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.
Validate order details and preview costs before creating. Use this endpoint to verify offer availability, calculate estimated costs, and check shipping feasibility before creating an external order.
post/open-api/v1.0/external-orders/validate
Request body
Example request
{
"items": [
{
"variantId": "c2b6d0e3-4f5g-6h7i-8j9k-0l1m2n3o4p5q"
}
],
"shippingAddress": {
"firstName": "John",
"lastName": "Doe",
"address1": "123 Main Street",
"address2": "Apt 4B",
"city": "San Francisco",
"state": "CA",
"zip": "94105",
"country": "US",
"phone": "+1-555-123-4567"
}
}Response
OK
Example response
{
"estimatedCosts": {
"fulfillmentFee": {
"value": 10,
"currency": "USD"
},
"manufacturingCost": {
"value": 10,
"currency": "USD"
},
"shippingCost": {
"value": 10,
"currency": "USD"
},
"totalCreatorCost": {
"value": 10,
"currency": "USD"
}
}
}