How to get closeout products

Closeout products are items that suppliers are discontinuing or clearing from inventory, often available at discounted prices. The PromoStandards method for retrieving these products is getProductCloseOut.

Function getProductCloseOut

This endpoint returns a list of products that are currently on closeout for a given supplier. Use this to find deals on products being phased out.

HTTP VERB: `GET`

URL: https://api.psrestful.com/v2.0.0/suppliers/{SUPPLIER_CODE}/products-closeout/

Query Parameters

Parameter	Type	Default	Description
`environment`	string	PROD	Environment: `PROD` or `STAGING`

Example Request

curl -X GET "https://api.psrestful.com/v2.0.0/suppliers/HIT/products-closeout/" \
  -H "X-API-Key: your-api-key"

Example Response

COMPLETE URL:

https://api.psrestful.com/v2.0.0/suppliers/HIT/products-closeout/

{
    "ProductCloseOutArray": {
        "ProductCloseOut": [
            {
                "productId": "4521",
                "partId": "4521BLK"
            },
            {
                "productId": "4521",
                "partId": "4521BLU"
            },
            {
                "productId": "6234",
                "partId": "6234RED"
            }
        ]
    },
    "ServiceMessageArray": null
}

Response Structure

The response contains a ProductCloseOutArray with ProductCloseOut items, each containing:

Field	Description
`productId`	The product identifier
`partId`	The specific part/variant identifier that is on closeout

Use Cases

Bargain hunting: Find discounted products for price-sensitive customers
Inventory clearance: Help customers find deals before products become unavailable
Catalog updates: Identify products to remove or mark as closeout in your catalog
Purchasing decisions: Stock up on popular closeout items before they’re gone

API Versions

Both v1.0.0 and v2.0.0 are supported:

https://api.psrestful.com/v1.0.0/suppliers/{SUPPLIER_CODE}/products-closeout/
https://api.psrestful.com/v2.0.0/suppliers/{SUPPLIER_CODE}/products-closeout/

How to get all sellable products - Get the full list of sellable products
How to get product details - Get detailed information for a specific product
How to get products modified since a date - Track product changes over time

Get Products Modified Since Get Product Media Content