This project is under active development. The API may change before version 1.0.0.
Installation
Install the SDK via npm, yarn, or pnpm
Quickstart
Make your first API call in minutes
API Reference
Explore the complete API documentation
What is PromoStandards?
PromoStandards is an industry-wide initiative to standardize data integration between suppliers, distributors, and decorators in the promotional products industry. The standards define SOAP-based web services for:- Product data - Retrieve detailed product information and specifications
- Media content - Access product images and marketing materials
- Inventory - Check real-time stock availability
- Pricing & configuration - Get pricing and decoration options
- Order management - Track order status and shipments
Key features
TypeScript support
Full type definitions for enhanced developer experience and type safety
Flexible response formats
Choose between XML or JSON responses based on your needs
Promise-based API
Modern async/await interface for clean, readable code
Multiple service versions
Support for different PromoStandards service versions
Complete API coverage
Access all major PromoStandards services from a single client
Well-tested
Comprehensive test coverage for reliability
Supported services
The SDK provides access to the following PromoStandards services:- Product Data 2.0.0 - Product information, sellable products, close-outs
- Media Content 1.1.0 - Product images and media assets
- Inventory 2.0.0 - Stock levels and filter values
- Product Pricing & Configuration 1.0.0 - Pricing, decoration options, and locations
- Order Status - Track order details and status types
- Order Shipment Notification - Receive shipment updates
- Purchase Order - Submit purchase orders
- Invoice - Retrieve invoices
Next steps
Ready to get started? Follow our installation guide to add the SDK to your project.Install the SDK
Learn how to install and configure the PromoStandards SDK