What PSRESTful is and who uses it

PSRESTful gives you suppliers' PromoStandards data through one REST API and a dashboard, so you don't build and maintain each integration yourself.

Product
PSRESTful
Plan
Every plan
Updated
November 2026

PSRESTful is a REST/JSON API on top of PromoStandards, the web services promotional product suppliers use to share their data. You get product details, images, prices, stock, order status, shipments and invoices from the suppliers we've integrated through one API and one dashboard, instead of building and maintaining a separate integration for each supplier.

What it does

Suppliers publish their data through PromoStandards services that use SOAP and XML, and each supplier implements them a little differently. PSRESTful calls those services for you and returns JSON in the same shape whichever supplier you ask. The connected suppliers are listed on the Integrated Suppliers page.

You can use it two ways:

  • The dashboard. Tools at psrestful.com that need no code. Look at a supplier's products in the Data Explorer, compare stock across suppliers in Stock Check, look up orders, shipments and invoices, and export product files for your store.
  • The API. Your developer, or your store, ERP or quoting software, asks for the same data directly.

Both run on the same account, the same supplier credentials and the same daily calls: the dashboard tools call the API with your account's key. If you sell on Shopify, PromoSync is our Shopify app built on PSRESTful. Dashboard, API or PromoSync goes through the differences.

Who uses it

  • Owners and managers at distributors who want supplier data in their store or systems without paying to build and maintain an integration for every supplier.
  • Operations and customer service teams who check order status, shipments and invoices across suppliers in one place instead of contacting each supplier.
  • Developers and integrators who would rather work with JSON and one set of docs than with SOAP requests and each supplier's quirks.
  • Suppliers who want to see their own PromoStandards data the way a distributor's integration receives it.

Each person on an account has a role (Admin, Developer, Operations, Product Specialist or Customer Support) that decides which pages they see. See managing users.

What it saves you from

Connecting to suppliers in-house means doing all of this for every supplier you add:

  • Writing SOAP clients and parsing XML responses.
  • Working around differences in how each supplier implements the same service: a field one supplier always fills and another leaves out, methods a supplier never built, documentation that leaves room for interpretation.
  • Matching part IDs that don't line up between a supplier's media, stock and pricing services.
  • Tracking which endpoint and service version each supplier runs, and keeping every connection working over time.

PSRESTful does that work for every integrated supplier, and you call one API.

What it can't do

PSRESTful can't give you access a supplier hasn't granted. Public catalog data (product details, images, net and list prices, stock) works with our shared credentials for suppliers marked Credentials Available on the Integrated Suppliers page. Your own customer pricing, purchase orders, order status, shipments and invoices need credentials the supplier issues to your company. Agent credentials vs your own explains the difference.

For developers

The API is at https://api.psrestful.com/ and takes your key in an x-api-key header. The interactive reference is at api.psrestful.com/docs, and guides for each service are at docs.psrestful.com.

Where to go next

Did this answer your question?

Tell us in your own words, or paste the error. It goes to our team with this article attached.