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 · headerrequired

API token from the SIBI developer dashboard (developer.sibipro.com), sent as Authorization: Bearer <token>.

Scopes:read:draft-orders

Path parameters

idstringrequired

Responses

200

The draft order was found.

idstringrequired

The unique identifier for the draft order.

createdAtstringrequired

supplierstringrequired

addressOrderPropertyAddressrequired

Show properties

line1stringrequired

line2string | nullrequired

citystringrequired

stateOrProvincestringrequired

postalCodestringrequired

countrystring | nullrequired

contactInfoobject | nullrequired

Show properties

firstNamestring | nullrequired

lastNamestring | nullrequired

emailstringrequired

phonestring | nullrequired

poNumberstring | nullrequired

specialInstructionsstring | nullrequired

lineItemsDraftOrderLineItem[]required

The priced line items, with the options, addons, warranties, and availability resolved for each.

Show properties

Array of DraftOrderLineItem

skustringrequired

namestringrequired

subtitlestring | nullrequired

imageUrlstringrequired

quantityintegerrequired

unitOfMeasurestringrequired

quantityPerBaseUnitnumberrequired

The number of baseUnitOfMeasure contained in each unitOfMeasure. Multiply by quantity for the total in the base unit.

baseUnitOfMeasurestringrequired

priceCentsintegerrequired

Price in cents per base unit.

availabilityStatusstringrequired

Availability of the product in the draft's distribution center.

Allowed:IN_STOCKOUT_OF_STOCKSUBSTITUTION_ONLYUNAVAILABLEUNKNOWN

optionsDraftOrderLineItemOption[]required

The options selected on this line.

Show properties

Array of DraftOrderLineItemOption

keystringrequired

The option identifier.

valuestringrequired

The selected value identifier.

namestringrequired

Human readable name of the value.

hexstring | nullrequired

CSS hex color of the value, for values that represent a color. Null when it has none.

attributesDraftOrderLineItemAttribute[]required

Catalog attributes of this product relevant to ordering it. Empty when it has none.

Show properties

Array of DraftOrderLineItemAttribute

namestringrequired

valuestringrequired

addonsDraftOrderAddon[]required

The addons attached to this line.

Show properties

Array of DraftOrderAddon

idstringrequired

Pass this as an addonIds entry to attach the addon.

titlestringrequired

priceCentsintegerrequired

availableAddonsDraftOrderAddon[]required

Addons that can be attached to this line.

Show properties

Array of DraftOrderAddon

idstringrequired

Pass this as an addonIds entry to attach the addon.

titlestringrequired

priceCentsintegerrequired

availableWarrantiesDraftOrderWarranty[]required

Warranties that can be purchased alongside this line.

Show properties

Array of DraftOrderWarranty

skustringrequired

Pass this as warrantySku on the line item to attach the warranty.

namestringrequired

descriptionstring | nullrequired

manufacturerstringrequired

priceCentsintegerrequired

selectedWarrantyobjectrequired

Show properties

skustringrequired

Pass this as warrantySku on the line item to attach the warranty.

namestringrequired

descriptionstring | nullrequired

manufacturerstringrequired

priceCentsintegerrequired

distributionCenterDraftOrderDistributionCenterrequired

The distribution center the order would be fulfilled from.

Show properties

idstringrequired

namestringrequired

storeNumberstringrequired

May not actually be numeric.

phonestring | nullrequired

The distribution center's phone number as the distributor publishes it. Null when not provided.

addressOrderPropertyAddressrequired

Show properties

line1stringrequired

line2string | nullrequired

citystringrequired

stateOrProvincestringrequired

postalCodestringrequired

countrystring | nullrequired

fulfillmentMethodDraftOrderFulfillmentMethodrequired

The fulfillment method resolved for this draft.

Show properties

idstringrequired

titlestringrequired

descriptionstring | nullrequired

typestringrequired

Allowed:DELIVERYPICKUP

availableDatesstring[]required

The dates this method can fulfill on. Pass one as requestedDeliveryDate when placing the order.

availableFulfillmentMethodsDraftOrderFulfillmentMethod[]required

Every fulfillment method available for this order, with the dates each can fulfill on.

Show properties

Array of DraftOrderFulfillmentMethod

idstringrequired

titlestringrequired

descriptionstring | nullrequired

typestringrequired

Allowed:DELIVERYPICKUP

availableDatesstring[]required

The dates this method can fulfill on. Pass one as requestedDeliveryDate when placing the order.

requestedDeliveryDatestringrequired

paymentMethodIdstringrequired

The payment method resolved for this draft.

availablePaymentMethodsDraftOrderPaymentMethod[]required

Every payment method available to this caller for this order.

Show properties

Array of DraftOrderPaymentMethod

idstringrequired

Pass this as paymentMethodId when placing the order.

typestringrequired

Allowed:MANUFACTURER_CREDITSTRIPE

descriptionstringrequired

last4string | nullrequired

The saved card's last four digits. Null for non-card methods.

pricingDraftOrderPricingrequired

Show properties

subtotalCentsintegerrequired

taxCentsintegerrequired

totalPriceCentsintegerrequired

Subtotal plus tax and fees, less discounts.

feesobject[]required

Show properties

Array of object

namestringrequired

amountCentsintegerrequired

discountsobject[]required

Show properties

Array of object

namestringrequired

amountCentsintegerrequired

subscribersobject[]required

Show properties

Array of object

emailstringrequired

400

Bad request - Invalid input data

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

401

Unauthorized - Missing or invalid authentication

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

403

Forbidden - The token is missing the scope this operation requires, or was minted for the other environment

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

404

Not found - no draft order with this id is visible to the caller

codestringrequired

Error code indicating the type of error

Allowed:DRAFT_ORDER_NOT_FOUND

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

500

Internal server error

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

Request

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",
    "phone": "6233885100",
    "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"
    }
  ]
}