Skip to content
SIBISIBI Developers
Esc
↑↓navigate↵open⌘Jpreview

Search the product catalog

Searches published products by free-text term, supplier, category, and physical dimensions. Returns a page of product summaries; supply an address to include pricing, availability (with the per-distribution-center breakdown), recommended parts, add-ons, and warranties, and set includeAvailableFulfillmentMethods to add fulfillment methods. Warning: resolving fulfillment methods is slow and grows with the number of matching products, so on a broad search term the request can time out and return a 500. Narrow the search to specific SKUs before turning the flag on. after is an opaque cursor from a previous response; do not construct one by hand. Requires a Public REST API token that carries the read:products scope. Create one in the SIBI developer dashboard (developer.sibipro.com) and grant it that scope; tokens issued for the GraphQL API are refused.

GET/
Authorization
AuthorizationBearer token · headerrequired

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

Scopes:read:products
Query parameters
searchTermstring
min length 1 · max length 200
supplierstring
categoriesstring
minWidthnumber
maxWidthnumber
minHeightnumber
maxHeightnumber
minDepthnumber
maxDepthnumber
minLengthnumber
maxLengthnumber
firstinteger
min 1 · max 100 · default: 36
afterstring
line1string
min length 1 · max length 100
line2string
min length 1 · max length 100
citystring
min length 1 · max length 100
stateOrProvincestring
min length 2 · max length 2
postalCodestring
matches ^\d{5}(-\d{4})?$
onlyInStockboolean
includeAvailableFulfillmentMethodsboolean
Responses
200

Search results retrieved successfully

itemsProductSearchItem[]required
Show properties
Array of ProductSearchItem
skustringrequired
supplierstringrequired

The supplier of the product.

namestringrequired

The product name.

shortDescriptionstringrequired

A compact spec/dimension/material line. May be an empty string when the catalog has none for this product.

descriptionstringrequired

Free-text product description. Completeness varies by supplier — may be empty, a single word, or a full paragraph.

imageUrlsstring[]required

URLs of the product images. Empty when the catalog has none for this product.

categorystringrequired

The product category (e.g. "Ranges").

subcategoriesstring[]required

The specific subcategories this product falls into. May be empty, and may repeat category when the catalog has no finer grouping.

attributesobject[]required

Catalog attributes relevant to ordering this product. Which attributes a product carries varies by product; empty when it has none.

Show properties
Array of object
namestringrequired

The attribute identifier.

valuestringrequired

The attribute value.

baseUnitOfMeasurestringrequired

The unit priceCents is denominated in (e.g. "Each", "Sq Ft"). When unitsOfMeasure is non-empty, the product cannot be purchased in fractional amounts of this base unit directly — pass one of unitsOfMeasure's unitOfMeasure values as unitOfMeasure when creating an order. When unitsOfMeasure is empty, pass this value instead (or omit unitOfMeasure to default to it).

unitsOfMeasureobject[]required

Alternate purchasable units for this product — e.g. a flooring product priced by the Sq Ft that can only be ordered by the Box or Pallet, each covering a fixed quantity of baseUnitOfMeasure. Empty when the product has no alternate units and can be ordered directly in baseUnitOfMeasure.

Show properties
Array of object
unitOfMeasurestringrequired

The unit to pass as unitOfMeasure when creating an order for this product in this unit.

quantityPerBaseUnitnumberrequired

The number of baseUnitOfMeasure contained in each of this unit. Multiply by the requested quantity of this unit to get the total in the base unit.

optionsobject[]required

The selectable option values for this product, one entry per value; entries sharing a key are alternative values for the same option. Empty when the product has no selectable options. For products with a required option (e.g. PPG tintable paints), one { key, value } pair per option must be included in products[].options when creating an order. This list holds each option's standard values; other valid values may exist beyond it (e.g. the full PPG color catalog), and any valid value identifier is accepted at order time.

Show properties
Array of object
keystringrequired

The option identifier. Pass it as key in products[].options when creating an order.

valuestringrequired

The value identifier. Pass it as value in products[].options when creating an order.

namestringrequired

The display name of the value.

hexstring | nullrequired

CSS hex color of the value, when the value is a color.

dimensionsProductDimensionsrequired

The product's physical dimensions as the catalog records them, without unit conversion. These are the same values the dimension bound query parameters compare against. Every key is always present; a null value means the catalog has no measurement for that axis.

Show properties
widthnumber | nullrequired

The product width, in widthUnit. Null when the catalog has no width.

widthUnitstring | nullrequired

The unit of width. Null when width is null.

heightnumber | nullrequired

The product height, in heightUnit. Null when the catalog has no height.

heightUnitstring | nullrequired

The unit of height. Null when height is null.

depthnumber | nullrequired

The product depth, in depthUnit. Null when the catalog has no depth.

depthUnitstring | nullrequired

The unit of depth. Null when depth is null.

lengthnumber | nullrequired

The product length, in lengthUnit. Null when the catalog has no length.

lengthUnitstring | nullrequired

The unit of length. Null when length is null.

availabilityobject | nullrequired

Availability at the address supplied on the request. Null when no address was supplied — the key is always present, and null means "not asked for", not "out of stock".

Show properties
statusstringrequired

Stock status at the supplied address. UNKNOWN means the availability check failed or the distributor reports no data for this product — it is not a claim that the product is out of stock.

Allowed:IN_STOCKOUT_OF_STOCKUNAVAILABLEUNKNOWN
quantityinteger | nullrequired

Units on hand where the distributor reports a count; null when it does not.

min 0
distributionCentersobject[]required

Per-distribution-center availability breakdown. Each entry represents a distribution center that carries this product. Only populated when an address is provided. Returns an empty array when distribution center information is unavailable.

Show properties
Array of object
statusstringrequired

Stock status of this product at this distribution center.

Allowed:IN_STOCKOUT_OF_STOCKUNAVAILABLEUNKNOWN
quantityintegerrequired

Units of this product on hand at this distribution center; 0 when the distributor reports no count.

min 0
distributionCenterSearchDistributionCenterrequired

The distribution center that carries this product.

Show properties
idstringrequired

The distribution center identifier to pass as distributionCenterId when creating an order.

namestringrequired
storeNumberstring | nullrequired

The distributor's store number. May not be numeric; null when the distributor has none.

phonestring | nullrequired

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

imageUrlstring | nullrequired

URL of the distribution center's logo, if any.

latitudenumberrequired
longitudenumberrequired
addressobjectrequired
Show properties
line1stringrequired
line2string | nullrequired
citystringrequired
stateOrProvincestringrequired
postalCodestringrequired
priceCentsinteger | nullrequired

Purchase price in cents for the supplied address. Populated when an address is supplied; null when no address is supplied or when no price is available for this product.

min 0
msrpPriceCentsinteger | nullrequired

The manufacturer's suggested retail price in cents. Populated when an address is supplied; null when no address is supplied or when the catalog has no MSRP for this product.

min 0
recommendedPartsobject[]required

Recommended parts for the product. These parts may be included in an add-on like "Install". The same set GET /products/{sku} returns as recommendedParts. Populated when an address is supplied; empty when no address is supplied or the product has none.

Show properties
Array of object
skustringrequired
namestringrequired
categorystringrequired
priceCentsinteger | nullrequired

Purchase price in cents at the supplied address; null when no price is available.

min 0
addOnsobject[]required

An array of add-ons (services and/or accessories) that can be ordered with the product. The same set GET /products/{sku} returns as addOns. Populated when an address is supplied; empty when no address is supplied or none are available.

Show properties
Array of object
idstringrequired

Sibi identifier for the add-on.

namestringrequired

The human readable name of the add-on.

priceCentsintegerrequired

The price of the add-on in cents.

min 0
productsobject[]required

The individual products that are included with each add-on. These are the skus that the distributor will reference on their invoices.

Show properties
Array of object
skustringrequired

The sku that the distributor will reference on their invoices. For add-ons within the GE shop, these skus will generally have the format of MXXX where XXX is numeric.

namestringrequired

The human readable name of the product.

categorystringrequired

The broad category this product falls into.

priceCentsinteger | nullrequired

The price of the product in cents; null when no price is available.

min 0
warrantiesobject[]required

Warranty products that can be attached to this product when creating an order, matched by the product's brand, category, and subcategories and limited to the shops visible to the caller. Populated when an address is supplied; empty when no address is supplied or none are available.

Show properties
Array of object
skustringrequired

The warranty product SKU to pass as warrantySku when creating an order.

namestringrequired

The human readable name of the warranty.

descriptionstring | nullrequired

A short description of the coverage; null when the catalog has none.

priceCentsinteger | nullrequired

The price of the warranty in cents at the supplied address; null when no price is available.

min 0
availableFulfillmentMethodsobject[]required

The fulfillment methods available for this product, each showing the earliest date it can be fulfilled and the distribution center that provides that date. Only populated when includeAvailableFulfillmentMethods is true and an address is provided. Returns an empty array otherwise, or when fulfillment information is unavailable.

Show properties
Array of object
idstringrequired

The fulfillment method identifier to pass as fulfillmentMethodId when creating an order.

namestringrequired
descriptionstring | nullrequired

An optional description of the method.

typestringrequired
Allowed:DELIVERYPICKUP
estimatedFulfillmentDatestringrequired

The earliest date this product can be fulfilled with this method across every distribution center that offers it. YYYY-MM-DD.

distributionCenterobjectrequired
Show properties
idstringrequired

The distribution center identifier to pass as distributionCenterId when creating an order.

namestringrequired
storeNumberstring | nullrequired

The distributor's store number. May not be numeric; null when the distributor has none.

phonestring | nullrequired

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

imageUrlstring | nullrequired

URL of the distribution center's logo, if any.

latitudenumberrequired
longitudenumberrequired
addressobjectrequired
Show properties
line1stringrequired
line2string | nullrequired
citystringrequired
stateOrProvincestringrequired
postalCodestringrequired
distributionCentersobject[]required

All distribution centers that offer this fulfillment method for this product, each with their own estimated fulfillment date. Sorted by estimated fulfillment date ascending (earliest first).

Show properties
Array of object
estimatedFulfillmentDatestringrequired
distributionCenterobjectrequired
Show properties
idstringrequired

The distribution center identifier to pass as distributionCenterId when creating an order.

namestringrequired
storeNumberstring | nullrequired

The distributor's store number. May not be numeric; null when the distributor has none.

phonestring | nullrequired

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

imageUrlstring | nullrequired

URL of the distribution center's logo, if any.

latitudenumberrequired
longitudenumberrequired
addressobjectrequired
Show properties
line1stringrequired
line2string | nullrequired
citystringrequired
stateOrProvincestringrequired
postalCodestringrequired
nextstring | nullrequired

Opaque cursor for the next page, or null when there are no more results.

400

Bad request - a query parameter this operation does not accept (UNKNOWN_QUERY_PARAMETER), or 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 was minted for the other environment, is not a Public REST API token, or does not carry the scope this operation requires

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
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
503

Service unavailable - the token-exchange service could not be reached (AUTH_UNAVAILABLE) or supplier visibility could not be resolved (SUPPLIER_VALIDATION_UNAVAILABLE); retry the request

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
504

The request timed out

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/products/" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "items": [
    {
      "sku": "string",
      "supplier": "ge",
      "name": "string",
      "shortDescription": "string",
      "description": "string",
      "imageUrls": [
        "string"
      ],
      "category": "string",
      "subcategories": [
        "string"
      ],
      "attributes": [
        {
          "name": "sheen",
          "value": "Satin"
        }
      ],
      "baseUnitOfMeasure": "Each",
      "unitsOfMeasure": [
        {
          "unitOfMeasure": "Box",
          "quantityPerBaseUnit": 23.77
        }
      ],
      "options": [
        {
          "key": "ppg-paint-color",
          "value": "PPG1025-3",
          "name": "Whiskers",
          "hex": "#C9C7BE"
        }
      ],
      "dimensions": {
        "width": 0,
        "widthUnit": "in",
        "height": 0,
        "heightUnit": "in",
        "depth": 0,
        "depthUnit": "in",
        "length": 0,
        "lengthUnit": "in"
      },
      "availability": {
        "status": "IN_STOCK",
        "quantity": 0,
        "distributionCenters": [
          {
            "status": "IN_STOCK",
            "quantity": 0,
            "distributionCenter": {
              "id": "ge-dc-phoenix",
              "name": "GE Appliances Phoenix",
              "storeNumber": "string",
              "phone": "6233885100",
              "imageUrl": "string",
              "latitude": 0,
              "longitude": 0,
              "address": {
                "line1": "string",
                "line2": "string",
                "city": "string",
                "stateOrProvince": "string",
                "postalCode": "string"
              }
            }
          }
        ]
      },
      "priceCents": 0,
      "msrpPriceCents": 0,
      "recommendedParts": [
        {
          "sku": "M236",
          "name": "Supply Gas Range Flex",
          "category": "Parts",
          "priceCents": 0
        }
      ],
      "addOns": [
        {
          "id": "install",
          "name": "Install",
          "priceCents": 0,
          "products": [
            {
              "sku": "M001",
              "name": "Basic Install",
              "category": "Install & Supply Services",
              "priceCents": 0
            }
          ]
        }
      ],
      "warranties": [
        {
          "sku": "W5YR-APPL",
          "name": "5 Year Extended Warranty",
          "description": "Covers parts and labor for 5 years",
          "priceCents": 0
        }
      ],
      "availableFulfillmentMethods": [
        {
          "id": "ge-standard-delivery",
          "name": "Standard Delivery",
          "description": "string",
          "type": "DELIVERY",
          "estimatedFulfillmentDate": "2026-09-02",
          "distributionCenter": {
            "id": "ge-dc-phoenix",
            "name": "GE Appliances Phoenix",
            "storeNumber": "string",
            "phone": "6233885100",
            "imageUrl": "string",
            "latitude": 0,
            "longitude": 0,
            "address": {
              "line1": "string",
              "line2": "string",
              "city": "string",
              "stateOrProvince": "string",
              "postalCode": "string"
            }
          },
          "distributionCenters": [
            {
              "estimatedFulfillmentDate": "2026-09-02",
              "distributionCenter": {
                "id": "ge-dc-phoenix",
                "name": "GE Appliances Phoenix",
                "storeNumber": "string",
                "phone": "6233885100",
                "imageUrl": "string",
                "latitude": 0,
                "longitude": 0,
                "address": {
                  "line1": "string",
                  "line2": "string",
                  "city": "string",
                  "stateOrProvince": "string",
                  "postalCode": "string"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "next": "string"
}