TD Synnex
POST

Catalogue

/resellers/v2/products/catalogue

Retrieve catalogue information about products by specifying one of the following search criteria: TD part number, manufacturer part number, UPC/EAN barcode, reseller part number, manufacturer, product class, or product sub-class. Only one search parameter may contain a non-null value per request. Supplying more than one search parameter with a non-null value will result in an invalid request. All search parameters accept null values. A null value is treated as “no filtering” for that field. If all supported search parameters are null, the request returns all available catalogue items.

Headers

Authorization
string*required

This API uses Bearer Token authentication. Include your token in the Authorization header as Bearer <token> to access the endpoint.

Content-type
string*required

TraceId
string

TraceId for tracking requests

Accept-Language
string

This Header parameter can be used to specify expected language for returned data. Requested language should be available in your country. If empty, default customer language will apply.

Allowed values:

cs-CZ
da-DK
de-AT
de-CH
de-DE
en-AT
en-AU
en-AZ
en-BE
en-CH
en-CZ
en-DE
en-DK
en-ES
en-FI

Body Parameters

tdsynnexPartNumber
array[string]nullable

An array of TD SYNNEX part numbers identifying the requested products. Values must be exact matches (no partial or wildcard values supported). Maximum of 50 part numbers per request.

manufPartNumber
array[string]nullable

List of manufacturer part numbers for the products. Can be extended to multiple products by using only the first values of the parts.

upcEan
array[string]nullable

Search by barcode with a list of UPC/EAN codes for the products. Requires exact values.

customerPartNumber
array[string]nullable

List of customer part numbers for the desired products. Requires exact value.

manufacturer
stringnullable

Name of the manufacturer for the products. This search parameter can be combined with class or subclass to further refine the results.

class
stringnullable

Product class. This search parameter can be combined with the manufacturer value to further refine the results. Only listed values are allowed.

Allowed values:

GENERAL
COMPORT
COMDESK
COMSER
INDUSTSYS
COMHAND
COMEBOOK
CALCS
POSSYSTEM
COMACCSER
TDCONFIG
PERMONIT
KEYBMICE
PERBARCO
OTHPERIFS
subclass
stringnullable

Product sub class. This search parameter can be combined with the manufacturer value to further refine the results. Only listed values are allowed.

Allowed values:

3DCONSUM
3DPRINTER
3PLASUS
3PLASUSGI
3PLBYOD
3PLDELL
3PLDELLGI
3PLHP
3PLHPGI
3PLLENGI
3PLLENOVO
3PLMICRGI
3PLMICROS
3PLOTHER
3PLOTHERG
includeStock
booleannullable

Boolean flag, stock details will be returned when set to true. Default value is false.

onlyInStock
boolean

Boolean flag, products with no stock available will not be returned when set to true. Default value is false.

includePrice
boolean

Boolean flag, basic pricing details will be returned when set to true. Default value is false.

includePricePerQuantity
boolean

Boolean flag, price per quantity details will be returned when set to true. Default value is false.

includeOutlet
boolean

Boolean flag. In addition to other matching criteria, outlet products and their pricing detail will be returned when set to true. Results will include outlet and non-outlet product, with outlet products being referenced in the response by "hasOutletOptions": "true" Default value is false.

includeEndUserPrice
boolean

Boolean flag. In addition to other matching criteria, products where end user price is specified will be returned when set to true. Results will include all products. With end user price specified, the response will include "hasEndUserPrice": "true" Default value is false.

page
integer*required

Current page index

pageSize
integer*required

Number of products returned in each page. Default value returned is 50, maximum 100.

modifiedFrom
string

Value in format YYYY-MM-DDTHH:mm:ss.SSS or MM/DD/YYYY HH:mm:ss.SSS used to return only products last modified starting on a specified date. If HH:mm:ss.SSS values are not included, 00:00:00.000 is applied by default. Modifications include, but are not limited to stock value. Price modifications are not included.

modifiedTo
string

Value in format YYYY-MM-DDTHH:mm:ss.SSS or MM/DD/YYYY HH:mm:ss.SSS used to return only products last modified on a specified date. If HH:mm:ss.SSS values are not included, 00:00:00.000 is applied by default. Modifications include, but are not limited to stock value. Price modifications are not included.

createdFrom
string

Value in format YYYY-MM-DDTHH:mm:ss.SSS or MM/DD/YYYY HH:mm:ss.SSS used to return only products added to the catalogue starting on a specified date. If HH:mm:ss.SSS values are not included, 00:00:00.000 is applied by default.

createdTo
string

Value in format YYYY-MM-DDTHH:mm:ss.SSS or MM/DD/YYYY HH:mm:ss.SSS used to return only products added to the catalogue until a specified date. If HH:mm:ss.SSS values are not included, 00:00:00.000 is applied by default.

eolDateFrom
string

Value in format YYYY-MM-DDTHH:mm:ss.SSS or MM/DD/YYYY HH:mm:ss.SSS used to return only products where the EoL date is specified from a certain date. If HH:mm:ss.SSS values are not included, 00:00:00.000 is applied by default. Results can include EoL values in the past or in the future for planned product decommissioning.

eolDateTo
string

Value in format YYYY-MM-DDTHH:mm:ss.SSS or MM/DD/YYYY HH:mm:ss.SSS used to return only products where the EoL date is specified until a certain date. If HH:mm:ss.SSS values are not included, 00:00:00.000 is applied by default. Results can include EoL values in the past or in the future for planned product decommissioning.

productStatusCode
string

Allows filtering the response payload by only including products with the specified status. Only listed values are allowed.

Allowed values:

Active
Allocated
Discontinued
PhasedOut

Responses

Code Sample

API Request

Response

Click Execute Request to start a request and see the response here!