Get draft order
Retrieves a draft order by the id returned from POST /draft-orders, with the options, pricing, and availability that draft resolved.
The body is the one POST /draft-orders returns, so a caller that drafts, reads the draft back, then places it with POST /draft-orders/{id}/order handles a single shape. The draft is returned as it was resolved: nothing is repriced on read, so a draft can describe availability or pricing that has since changed, and placing it can still be rejected.
A draft that does not exist and a draft belonging to another organization both return 404, so the endpoint cannot be used to discover which draft ids exist.
GET
/{id}Authorization
AuthorizationBearer token · headerrequiredAPI token from the SIBI developer dashboard (developer.sibipro.com), sent as `Authorization: Bearer <token>`.
Scopes:
read:draft-ordersPath parameters
idstringrequiredResponses
200The draft order was found.
idstringrequiredThe unique identifier for the draft order.
createdAtstringrequiredsupplierstringrequiredaddressOrderPropertyAddressrequiredShow propertiesHide properties
line1stringrequiredline2string | nullrequiredcitystringrequiredstateOrProvincestringrequiredpostalCodestringrequiredcountrystring | nullrequiredcontactInfoobject | nullrequiredShow propertiesHide properties
firstNamestring | nullrequiredlastNamestring | nullrequiredemailstringrequiredphonestring | nullrequiredpoNumberstring | nullrequiredspecialInstructionsstring | nullrequiredlineItemsDraftOrderLineItem[]requiredThe priced line items, with the options, addons, warranties, and availability resolved for each.
Show propertiesHide properties
Array of
DraftOrderLineItemskustringrequirednamestringrequiredsubtitlestring | nullrequiredimageUrlstringrequiredquantityintegerrequiredunitOfMeasurestringrequiredquantityPerBaseUnitnumberrequiredThe number of `baseUnitOfMeasure` contained in each `unitOfMeasure`. Multiply by quantity for the total in the base unit.
baseUnitOfMeasurestringrequiredpriceCentsintegerrequiredPrice in cents per base unit.
availabilityStatusstringrequiredAvailability of the product in the draft's distribution center.
Allowed:
IN_STOCKOUT_OF_STOCKSUBSTITUTION_ONLYUNAVAILABLEUNKNOWNoptionsDraftOrderLineItemOption[]requiredThe options selected on this line.
Show propertiesHide properties
Array of
DraftOrderLineItemOptionkeystringrequiredThe option identifier.
valuestringrequiredThe selected value identifier.
namestringrequiredHuman readable name of the value.
hexstring | nullrequiredCSS hex color of the value, for values that represent a color. Null when it has none.
attributesDraftOrderLineItemAttribute[]requiredCatalog attributes of this product relevant to ordering it. Empty when it has none.
Show propertiesHide properties
Array of
DraftOrderLineItemAttributenamestringrequiredvaluestringrequiredaddonsDraftOrderAddon[]requiredThe addons attached to this line.
Show propertiesHide properties
Array of
DraftOrderAddonidstringrequiredPass this as an `addonIds` entry to attach the addon.
titlestringrequiredpriceCentsintegerrequiredavailableAddonsDraftOrderAddon[]requiredAddons that can be attached to this line.
Show propertiesHide properties
Array of
DraftOrderAddonidstringrequiredPass this as an `addonIds` entry to attach the addon.
titlestringrequiredpriceCentsintegerrequiredavailableWarrantiesDraftOrderWarranty[]requiredWarranties that can be purchased alongside this line.
Show propertiesHide properties
Array of
DraftOrderWarrantyskustringrequiredPass this as `warrantySku` on the line item to attach the warranty.
namestringrequireddescriptionstring | nullrequiredmanufacturerstringrequiredpriceCentsintegerrequiredselectedWarrantyobjectrequiredShow propertiesHide properties
skustringrequiredPass this as `warrantySku` on the line item to attach the warranty.
namestringrequireddescriptionstring | nullrequiredmanufacturerstringrequiredpriceCentsintegerrequireddistributionCenterDraftOrderDistributionCenterrequiredThe distribution center the order would be fulfilled from.
Show propertiesHide properties
idstringrequirednamestringrequiredstoreNumberstringrequiredMay not actually be numeric.
addressOrderPropertyAddressrequiredShow propertiesHide properties
line1stringrequiredline2string | nullrequiredcitystringrequiredstateOrProvincestringrequiredpostalCodestringrequiredcountrystring | nullrequiredfulfillmentMethodDraftOrderFulfillmentMethodrequiredThe fulfillment method resolved for this draft.
Show propertiesHide properties
idstringrequiredtitlestringrequireddescriptionstring | nullrequiredtypestringrequiredAllowed:
DELIVERYPICKUPavailableDatesstring[]requiredThe dates this method can fulfill on. Pass one as `requestedDeliveryDate` when placing the order.
availableFulfillmentMethodsDraftOrderFulfillmentMethod[]requiredEvery fulfillment method available for this order, with the dates each can fulfill on.
Show propertiesHide properties
Array of
DraftOrderFulfillmentMethodidstringrequiredtitlestringrequireddescriptionstring | nullrequiredtypestringrequiredAllowed:
DELIVERYPICKUPavailableDatesstring[]requiredThe dates this method can fulfill on. Pass one as `requestedDeliveryDate` when placing the order.
requestedDeliveryDatestringrequiredpaymentMethodIdstringrequiredThe payment method resolved for this draft.
availablePaymentMethodsDraftOrderPaymentMethod[]requiredEvery payment method available to this caller for this order.
Show propertiesHide properties
Array of
DraftOrderPaymentMethodidstringrequiredPass this as `paymentMethodId` when placing the order.
typestringrequiredAllowed:
MANUFACTURER_CREDITSTRIPESIBI_INVOICINGdescriptionstringrequiredlast4string | nullrequiredThe saved card's last four digits. Null for non-card methods.
pricingDraftOrderPricingrequiredShow propertiesHide properties
subtotalCentsintegerrequiredtaxCentsintegerrequiredtotalPriceCentsintegerrequiredSubtotal plus tax and fees, less discounts.
feesobject[]requiredShow propertiesHide properties
Array of
objectnamestringrequiredamountCentsintegerrequireddiscountsobject[]requiredShow propertiesHide properties
Array of
objectnamestringrequiredamountCentsintegerrequiredsubscribersobject[]requiredShow propertiesHide properties
Array of
objectemailstringrequired400Bad request - Invalid input data
codestringrequiredError code indicating the type of error
messagestringrequiredHuman-readable error message explaining what went wrong
detailsobject[]Detailed validation errors when applicable
Show propertiesHide properties
Array of
objectfieldstringrequirederrorstringrequired401Unauthorized - Missing or invalid authentication
codestringrequiredError code indicating the type of error
messagestringrequiredHuman-readable error message explaining what went wrong
detailsobject[]Detailed validation errors when applicable
Show propertiesHide properties
Array of
objectfieldstringrequirederrorstringrequired403Forbidden - The token is missing the scope this operation requires, or was minted for the other environment
codestringrequiredError code indicating the type of error
messagestringrequiredHuman-readable error message explaining what went wrong
detailsobject[]Detailed validation errors when applicable
Show propertiesHide properties
Array of
objectfieldstringrequirederrorstringrequired404Not found - no draft order with this id is visible to the caller
codestringrequiredError code indicating the type of error
Allowed:
DRAFT_ORDER_NOT_FOUNDmessagestringrequiredHuman-readable error message explaining what went wrong
detailsobject[]Detailed validation errors when applicable
Show propertiesHide properties
Array of
objectfieldstringrequirederrorstringrequired500Internal server error
codestringrequiredError code indicating the type of error
messagestringrequiredHuman-readable error message explaining what went wrong
detailsobject[]Detailed validation errors when applicable
Show propertiesHide properties
Array of
objectfieldstringrequirederrorstringrequiredRequest
curl -X GET "https://api.sibipro.com/draft-orders/TEMP-1234" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.sibipro.com/draft-orders/TEMP-1234", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});Response
{
"id": "string",
"createdAt": "2026-08-31T00:00:00.000Z",
"supplier": "ge",
"address": {
"line1": "1630 W Guadalupe Rd",
"line2": "Ste 101",
"city": "Gilbert",
"stateOrProvince": "AZ",
"postalCode": "85233",
"country": "USA"
},
"contactInfo": {
"firstName": "string",
"lastName": "string",
"email": "string",
"phone": "string"
},
"poNumber": "string",
"specialInstructions": "string",
"lineItems": [
{
"sku": "string",
"name": "string",
"subtitle": "string",
"imageUrl": "string",
"quantity": 0,
"unitOfMeasure": "Each",
"quantityPerBaseUnit": 23.77,
"baseUnitOfMeasure": "sq ft",
"priceCents": 0,
"availabilityStatus": "IN_STOCK",
"options": [
{
"key": "ppg-paint-color",
"value": "PPG1105-3",
"name": "Delicate White",
"hex": "#F0EFEA"
}
],
"attributes": [
{
"name": "sheen",
"value": "Satin"
}
],
"addons": [
{
"id": "string",
"title": "Haul Away",
"priceCents": 0
}
],
"availableAddons": [
{
"id": "string",
"title": "Haul Away",
"priceCents": 0
}
],
"availableWarranties": [
{
"sku": "string",
"name": "string",
"description": "string",
"manufacturer": "string",
"priceCents": 0
}
],
"selectedWarranty": {
"sku": "string",
"name": "string",
"description": "string",
"manufacturer": "string",
"priceCents": 0
}
}
],
"distributionCenter": {
"id": "ge-dc-lax",
"name": "string",
"storeNumber": "string",
"address": {
"line1": "1630 W Guadalupe Rd",
"line2": "Ste 101",
"city": "Gilbert",
"stateOrProvince": "AZ",
"postalCode": "85233",
"country": "USA"
}
},
"fulfillmentMethod": {
"id": "sibi-sibi-default-delivery",
"title": "Standard Delivery",
"description": "string",
"type": "DELIVERY",
"availableDates": [
"string"
]
},
"availableFulfillmentMethods": [
{
"id": "sibi-sibi-default-delivery",
"title": "Standard Delivery",
"description": "string",
"type": "DELIVERY",
"availableDates": [
"string"
]
}
],
"requestedDeliveryDate": "2026-09-01",
"paymentMethodId": "string",
"availablePaymentMethods": [
{
"id": "MANUFACTURER_CREDIT",
"type": "MANUFACTURER_CREDIT",
"description": "On account",
"last4": "string"
}
],
"pricing": {
"subtotalCents": 0,
"taxCents": 0,
"totalPriceCents": 0,
"fees": [
{
"name": "string",
"amountCents": 0
}
],
"discounts": [
{
"name": "string",
"amountCents": 0
}
]
},
"subscribers": [
{
"email": "string"
}
]
}{
"code": "string",
"message": "The request contains invalid parameters",
"details": [
{
"field": "customer.email",
"error": "Invalid email"
},
{
"field": "address.postalCode",
"error": "Invalid"
}
]
}{
"code": "string",
"message": "The request contains invalid parameters",
"details": [
{
"field": "customer.email",
"error": "Invalid email"
},
{
"field": "address.postalCode",
"error": "Invalid"
}
]
}{
"code": "string",
"message": "The request contains invalid parameters",
"details": [
{
"field": "customer.email",
"error": "Invalid email"
},
{
"field": "address.postalCode",
"error": "Invalid"
}
]
}{
"code": "DRAFT_ORDER_NOT_FOUND",
"message": "The request contains invalid parameters",
"details": [
{
"field": "customer.email",
"error": "Invalid email"
},
{
"field": "address.postalCode",
"error": "Invalid"
}
]
}{
"code": "string",
"message": "The request contains invalid parameters",
"details": [
{
"field": "customer.email",
"error": "Invalid email"
},
{
"field": "address.postalCode",
"error": "Invalid"
}
]
}