PromoStandards API Endpoint Directory

Getting Started

All endpoints below are live PromoStandards-compliant SOAP services hosted on promostandards.scrubauthority.com. To integrate:

Available Services
Operations & Documentation
GetProduct

Retrieves full product data for a given product ID, including descriptions, colors, sizes, and attributes. The primary operation for syncing product catalogs.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 2.0.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
localizationCountrystringRequiredISO 3166 country code (e.g. US)
localizationLanguagestringRequiredISO 639‑1 language code (e.g. en)
productIdstringRequiredSupplier product ID / SKU
partIdstringOptionalSpecific part/variant ID
Sample SOAP Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="http://www.promostandards.org/wsdl/ProductDataService/2.0.0/">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:GetProductRequest>
      <ns:wsVersion>2.0.0</ns:wsVersion>
      <ns:id>YOUR_USERNAME</ns:id>
      <ns:password>YOUR_PASSWORD</ns:password>
      <ns:localizationCountry>US</ns:localizationCountry>
      <ns:localizationLanguage>en</ns:localizationLanguage>
      <ns:productId>SA101</ns:productId>
    </ns:GetProductRequest>
  </soapenv:Body>
</soapenv:Envelope>
GetProductSellable

Returns the list of sellable products (or sellable parts for a given product). Use this to discover the full catalog or check if a specific product is available for sale.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringOptionalFilter to a specific product ID; omit for full catalog
partIdstringOptionalFilter to a specific part/variant
isSellablebooleanOptionalFilter by sellable status
GetProductCloseOut

Returns products or parts that have been marked as close-out or discontinued. Use this to remove end-of-life items from distributor catalogs.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
GetProductDateModified

Returns the IDs of products (and optionally parts) that have been modified after a specified date/time. Use for incremental catalog sync to avoid pulling the full catalog on every run.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
changeTimeStampdateTimeRequiredISO 8601 datetime — returns products modified after this value
Sample SOAP Request
<ns:GetProductDateModifiedRequest>
  <ns:wsVersion>2.0.0</ns:wsVersion>
  <ns:id>YOUR_USERNAME</ns:id>
  <ns:password>YOUR_PASSWORD</ns:password>
  <ns:changeTimeStamp>2024-01-01T00:00:00</ns:changeTimeStamp>
</ns:GetProductDateModifiedRequest>
Operations & Documentation
GetInventoryLevels

Returns current inventory levels for a product. Response includes quantity on hand, quantity available, and future inventory data broken down by part, color, and size.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 2.0.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
FiltercomplexOptionalOptional filter array of part/color/size values (see GetFilterValues)
Sample SOAP Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="http://www.promostandards.org/wsdl/Inventory/2.0.0/">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:GetInventoryLevelsRequest>
      <ns:wsVersion>2.0.0</ns:wsVersion>
      <ns:id>YOUR_USERNAME</ns:id>
      <ns:password>YOUR_PASSWORD</ns:password>
      <ns:productId>SA101</ns:productId>
    </ns:GetInventoryLevelsRequest>
  </soapenv:Body>
</soapenv:Envelope>
GetFilterValues

Returns the valid filter values (colors, sizes, part IDs) that can be passed to GetInventoryLevelsRequest. Call this first to know what filter combinations are supported for a given product.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
Operations & Documentation
GetAvailableLocations

Returns the decoration locations available on a product (e.g. Left Chest, Back, Sleeve). Start here before calling GetConfigurationAndPricing.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 1.0.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
localizationCountrystringRequiredISO 3166 country code
localizationLanguagestringRequiredISO 639‑1 language code
GetConfigurationAndPricing

The core pricing operation. Returns full configuration options and pricing for a product at a given decoration location, including quantity price breaks, decoration methods, and available sizes.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
partIdstringOptionalSpecific part/variant
currencystringRequiredISO 4217 currency code (e.g. USD)
fobIdstringOptionalSpecific FOB point ID
priceTypestringOptionalNet or List
localizationCountrystringRequiredISO 3166 country code
localizationLanguagestringRequiredISO 639‑1 language code
Sample SOAP Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="http://www.promostandards.org/wsdl/PricingAndConfiguration/1.0.0/">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:GetConfigurationAndPricingRequest>
      <ns:wsVersion>1.0.0</ns:wsVersion>
      <ns:id>YOUR_USERNAME</ns:id>
      <ns:password>YOUR_PASSWORD</ns:password>
      <ns:productId>SA101</ns:productId>
      <ns:currency>USD</ns:currency>
      <ns:localizationCountry>US</ns:localizationCountry>
      <ns:localizationLanguage>en</ns:localizationLanguage>
    </ns:GetConfigurationAndPricingRequest>
  </soapenv:Body>
</soapenv:Envelope>
GetAvailableCharges

Returns additional charges associated with decorating a product — such as setup fees, run charges, or digitizing fees — for a given location and decoration method.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
localizationCountrystringRequiredISO 3166 country code
localizationLanguagestringRequiredISO 639‑1 language code
GetFobPoints

Returns the available FOB (Freight on Board) shipping origin points. Use returned FOB IDs when calling GetConfigurationAndPricingRequest.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
GetDecorationColors

Returns the available decoration ink/thread colors for a specific decoration location and method on a product.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
productIdstringRequiredSupplier product ID
locationIdstringRequiredDecoration location ID (from GetAvailableLocations)
decorationIdstringRequiredDecoration method ID
localizationCountrystringRequiredISO 3166 country code
localizationLanguagestringRequiredISO 639‑1 language code
Operations & Documentation
GetMediaContent

Returns product images and other media assets (URLs, MIME types, dimensions, color associations). Supports filtering by media type and class to retrieve only what you need.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 1.1.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
cultureNamestringOptionalCulture/locale (e.g. en-US)
mediaTypestringOptionalImage, Video, Audio, Document
productIdstringRequiredSupplier product ID
partIdstringOptionalFilter to a specific part/color variant
ClassTypeintegerOptional1=Primary, 2=Alternate, 3=Lifestyle, 4=Thumbnail
Sample SOAP Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="http://www.promostandards.org/wsdl/MediaService/1.1.0/">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:GetMediaContentRequest>
      <ns:wsVersion>1.1.0</ns:wsVersion>
      <ns:id>YOUR_USERNAME</ns:id>
      <ns:password>YOUR_PASSWORD</ns:password>
      <ns:productId>SA101</ns:productId>
      <ns:mediaType>Image</ns:mediaType>
    </ns:GetMediaContentRequest>
  </soapenv:Body>
</soapenv:Envelope>
GetMediaDateModified

Returns a list of product IDs whose media has changed after a given timestamp. Use for incremental image sync — only re-fetch products with updated assets.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
changeTimeStampdateTimeRequiredISO 8601 datetime — returns products with media modified after this value
Operations & Documentation
GetOrderStatus

Returns the current status of one or more orders. Query by purchase order number, supplier order number, or a date range. Response includes line-level status and expected ship dates.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 2.0.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
queryTypeintegerRequired1=PO Number, 2=Supplier Order #, 3=Date Range
referenceNumberstringOptionalPO or order number (required for queryType 1 or 2)
statusTimeStampdateTimeOptionalStart of date range (required for queryType 3)
Sample SOAP Request (by PO Number)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="http://www.promostandards.org/wsdl/OrderStatusService/2.0.0/">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:GetOrderStatusRequest>
      <ns:wsVersion>2.0.0</ns:wsVersion>
      <ns:id>YOUR_USERNAME</ns:id>
      <ns:password>YOUR_PASSWORD</ns:password>
      <ns:queryType>1</ns:queryType>
      <ns:referenceNumber>PO-12345</ns:referenceNumber>
    </ns:GetOrderStatusRequest>
  </soapenv:Body>
</soapenv:Envelope>
GetServiceMethods

Returns the query types (methods) supported by this supplier's Order Status endpoint. Call this to confirm which queryType values are valid before querying order status.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
GetIssue

Returns any open issues or exceptions associated with a specific order — such as artwork problems, backorder alerts, or production holds. Allows distributors to proactively communicate delays to their customers.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
queryTypeintegerRequired1=PO Number, 2=Supplier Order #, 3=Date Range
referenceNumberstringOptionalPO or order number
Operations & Documentation
GetOrderShipmentNotification

Returns shipment notifications for fulfilled orders, including carrier, tracking numbers, ship date, and line-level shipped quantities. Poll this service to automatically update distributor order management systems with tracking information.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 2.0.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
queryTypeintegerRequired1=PO Number, 2=Supplier Order #, 3=Date Range
referenceNumberstringOptionalPO or order number (required for queryType 1 or 2)
shipmentTimestampdateTimeOptionalStart of date range for queryType 3
Sample SOAP Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:ns="http://www.promostandards.org/wsdl/OSN/2.0.0/">
  <soapenv:Header/>
  <soapenv:Body>
    <ns:GetOrderShipmentNotificationRequest>
      <ns:wsVersion>2.0.0</ns:wsVersion>
      <ns:id>YOUR_USERNAME</ns:id>
      <ns:password>YOUR_PASSWORD</ns:password>
      <ns:queryType>1</ns:queryType>
      <ns:referenceNumber>PO-12345</ns:referenceNumber>
    </ns:GetOrderShipmentNotificationRequest>
  </soapenv:Body>
</soapenv:Envelope>
Operations & Documentation
GetSupportedOrderTypes

Returns the order types accepted by this supplier (e.g. Blank, Sample, Production, Rush). Call this before submitting a PO to confirm the order type is supported.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version (e.g. 1.0.0)
idstringRequiredYour API username
passwordstringRequiredYour API password
SendPO

Submits a purchase order to Scrub Authority. This is the primary transaction operation — include full line-item detail, shipping address, decoration instructions, and artwork references. Response confirms receipt and provides the supplier order number.

ParameterTypeRequiredDescription
wsVersionstringRequiredService version
idstringRequiredYour API username
passwordstringRequiredYour API password
POcomplexRequiredFull PO object — see WSDL for complete schema
PO Object includes
FieldDescription
orderTypeBlank / Sample / Production / Rush
orderDateISO 8601 datetime the order was placed
lastModifiedISO 8601 datetime of last change
totalAmountExpected total order value
RushBoolean — request rush processing
LineItemArrayArray of line items (product, quantity, decoration)
ShipmentArrayArray of shipment destinations with addresses
ContactDistributor contact for this order

The SendPO schema is complex. Refer to the WSDL or the PromoStandards specification for the full message structure.

Authentication & Support

Authentication

All requests require a valid username (id) and password passed in the SOAP request body. Credentials are issued per distributor — they are not shared or publicly available.

Technical Support

For integration assistance, WSDL questions, or to report an issue with any endpoint: