Product API
Search the ABC Supply product catalog for items using different search criteria. Get product information with optional features such as same-family items and branch availability.
The Get Item endpoint returns information about a specific item sold at various branches The response includes details about the item and key product attributes, such as color, dimension, material hazard, size, image links, Proposition 65 warnings, and a reference to product hierarchy.
Product API
Get Item
GET /items/{itemNumber}
Get information for a specific item
Sandbox
Production
Authorization
OAuth 2.0 server or user token with the product.read scope.
Request
Example Request
Simple product request for an item number.
URI Parameters
The unique identifier {itemNumber} for a specific item.
GET /api/product/v1/items/02GASTZ3WW HTTP/1.1
Host: partners.abcsupply.com
Authorization: Bearer <TOKEN>Response
Example Response
The response with item information for the requested item number.
{
"itemNumber": "02GASTZ3WW",
"familyId": "PFam_3357501",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Weathered Wood 3 Bdl Per Square",
"status": "Active",
"familyItems": [
{
"itemNumber": "02GASTZ3PG",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Pewter Gray 3 Bundle Per Square",
"color": "Pewter Grey"
},
{
"itemNumber": "02GASTZ3SL",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Slate 3 Bundle Per Square",
"color": "Slate"
},
{
"itemNumber": "02GASTZ3WW",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Weathered Wood 3 Bdl Per Square",
"color": "Weatherwood"
},
{
"itemNumber": "02GASTZ3HG",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Hunter Green 3 Bundle Per Square",
"color": "Hunter Green"
},
{
"itemNumber": "02GASTZ3BW",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Barkwood 3 Bundle Per Square",
"color": "Barkwood"
},
{
"itemNumber": "02GASTZ3BI",
"itemDescription": "GAF Timberline High Definition with StrikeZone Shingles Birchwood 3 Bundle Per Square",
"color": "Birchwood"
},
{
"itemNumber": "02GASTZ3CH",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Charcoal 3 Bundle Per Square",
"color": "Charcoal"
},
{
"itemNumber": "02GASTZ3DW",
"itemDescription": "GAF Timberline High Definition with StrikeZone Shingles Driftwood 3 Bundle Per Square",
"color": "Driftwood"
},
{
"itemNumber": "02GASTZ3MB",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Mission Brown 3 Bundle Per Square",
"color": "Mission Brown"
},
{
"itemNumber": "02GASTZ3HI",
"itemDescription": "GAF StainGuard Timberline High Definition with StrikeZone Shingles Hickory 3 Bundle Per Square",
"color": "Hickory"
}
],
"color": {
"description": "Product Color",
"code": "384",
"name": "Gray"
}, and
"finish": {
"description": "Product Finish",
"code": "N/A",
"name": "Sanded"
},
"weights": [
{
"value": "1300",
"uom": "lbs",
"description": "Weight (lbs.)"
}
],
"uoms": [
{
"name": "Bundle",
"code": "BD",
"description": "Ordering UOM"
}
],
"dimensions": {
"width": {
"value": "4.9",
"uom": "ft",
"description": "Width (ft.)"
},
"thickness": {
"value": "1.5",
"uom": "in",
"description": "Thickness (in.)"
},
"height": {
"value": "1.5",
"uom": "in",
"description": "height (in.)"
},
"variations": [
{
"size": "1.5' X 4.5' X 4.9'",
"conversionFactor": 1,
"type": "standard",
"length": {
"value": "10",
"uom": "feet",
"uomCode": "ft",
"description": "Length (ft.)"
}
}
]
},
"specifications": [
{
"name": "Spec Warranty",
"code": "143",
"description": "Dimensional Shingles - 143"
},
{
"name": "Special Attributes",
"code": "24",
"description": "Standard Colors"
},
{
"name": "Size Profile",
"code": "610",
"description": "Metric"
},
{
"name": "Fire Rating",
"code": "Class A",
"description": "Class A"
},
{
"name": "10",
"code": "001",
"description": "Material Hazard"
}
],
"prop65Warnings": [
{
"label": "WARNING: This product can expose you to chemicals including Silica, crystalline (airborne particles of\nrespirable size),Titanium dioxide (airborne, unbound particles of respirable size), which are known to the State of\nCalifornia to cause cancer. For more information go to www.P65Warnings.ca.gov.",
"display": true,
"type": "chemical",
"locale": "English"
}
],
"images": [
{
"assetId": "02gastz3ww-product",
"type": "RepresentativeProductImageReference",
"href": "https://partners.abcsupply.com/product/v1/items/02GASTZ3WW/images/02gastz3ww-product"
}
],
"hierarchy": {
"productGroup": {
"name": "Steep Slope Products - 1",
"code": "1",
"label": "Steep Slope Products",
"description": "Steep Slope Products",
"category": {
"name": "Steep Slope Roofing (\n<gt />2:12 Pitch) - 13",
"code": "13",
"label": "Steep Slope Roofing ",
"description": "Steep Slope Roofing (\n<gt />2:12 Pitch)",
"productType": {
"name": "Fiberglass Laminated Shingle - 70",
"code": "70",
"label": "Fiberglass Laminated Shingle",
"description": "Fiberglass Laminated Shingle",
"materialComposition": {
"name": "Asphalt Composition Shingles And H& - 62",
"code": "62",
"label": "Asphalt Composition Shingles",
"description": "Asphalt Composition Shingles And H&",
"warranty": {
"name": "Dimensional Shingles - 143",
"code": "143",
"label": "Dimensional Shingles",
"description": "Dimensional Shingles",
"brandLine": {
"name": "GAF Timberline HD - 3232",
"code": "143",
"label": "GAF Timberline HD",
"description": "GAF Timberline HD"
}
}
}
}
}
}
},
"branches": [
{
"number": "409",
"name": "ABC Supply - Bililngs, MT",
"links": {
"self": "https://partner.abcsupply.com/location/v1/branches/409"
}
}
]
}Name
Type
Description
itemNumber
string
The unique identifier for the item.
familyId
string
The unique identifier for the product family.
itemDescription
string
The description of the item.
status
enum
The status of the item (e.g., “Active”, “Inactive”).
familyItems
array
The list of Items in the Product Family.
itemNumber
string
A unique series of alphanumeric characters used to identify the product.
itemDescription
string
The human readable description of the product.
color
string
Color Description.
color
object
The object describing the item color.
color.description
string
The description of the color.
color.code
string
The code for the color.
color.name
string
The name of the color.
finish
object
The object describing the finish of the item. (Available in a future release.)
finish.code
string
The code for the finish, if applicable. (Available in a future release.)
finish.name
string
The name of the finish. (Available in a future release.)
finish.description
string
The description of the finish. (Available in a future release.)
weights
array
The list of available weights of the item.
weights[].uom
enum
The unit of measure of the weight (e.g., “lbs”).
weights[].value
string
The value of the weight.
weights[].description
string
The description of the unit of measure for the weight (e.g., “Weight (lbs.)”).
uoms
array
The list of the units of measure of the item.
uoms[].name
string
The name of the unit of measure.
uoms[].code
string
The code of the unit of measure.
uoms[].description
string
The description of the unit of measure.
dimensions
object
The object describing product dimensions.
dimensions.width
object
The object describing the width of the item.
dimensions.width.uom
enum
The unit of measure of the width.
dimensions.width.value
string
The value of the width.
dimensions.width.description
string
The description of the width unit of measure (e.g., “Width (ft.)”).
dimensions.thickness
object
A object describing the thickness of the item.
dimensions.thickness.uom
enum
The unit of measure of the thickness.
dimensions.thickness.value
string
The value of the thickness.
dimensions.thickness.description
string
The description of the thickness unit of measure (e.g., “Thickness (in.)”).
dimensions.height
object
The object describing the height of the item. (Available in a future release.)
dimensions.height.uom
enum
The unit of measure of the height. (Available in a future release.)
dimensions.height.value
string
The value of the height. (Available in a future release.)
dimensions.height.description
string
The description of the height unit of measure (e.g., “Height (in.)”). (Available in a future release.)
dimensions.variations
array
The list of available variations for the length of the item.
dimensions.variations[].size
string
The text of the length variation. (Available in a future release.)
dimensions.variations[].conversionFactor
integer
The conversion factor, used for converting pricing unit of measure to ordering unit of measure.
dimensions.variations[].type
enum
The type of the variation (e.g., “standard”).
dimensions.variations[].length
object
The object describing the length variation for the item.
dimensions.variations[].length.uom
enum
The unit of measurement of the length dimension.
dimensions.variations[].length.value
string
The value of the length variation.
dimensions.variations[].length.description
string
The description of the length variation unit of measure (e.g., “Length (in).”).
dimensions.variations[].length.uomCode
string
The unit of measure code of the length variation.
specifications
array
The list of specifications for the item. (Available in a future release.)
specifications[].name
string
The name of a specification (e.g., “Spec Warranty”). (Available in a future release.)
specifications[].code
string
The code for the specification. (Available in a future release.)
specifications[].description
string
The description of the specification. (Available in a future release.)
prop65Warnings
array
The list of Proposition 65 warnings for the item.
prop65Warnings[].label
string
The text of the Proposition 65 warning.
prop65Warnings[].display
boolean
A Boolean specifying if the warning should be displayed.
prop65Warnings[].type
enum
The type of the Proposition 65 warning (e.g., “chemical”).
prop65Warnings[].locale
string
The localization language of the Proposition 65 warning.
images
array
The list of image links available for the item. (Available in a future release.)
images[].assetId
string
The asset ID of the image link. (Available in a future release.)
images[].type
enum
The type of image link (e.g., “RepresentativeProductImageReference”). (Available in a future release.)
images[].href
string
The URL for the image. (Available in a future release.)
hierarchy
object
The object describing the product hierarchy of the item.
hierarchy.productGroup
object
The object describing the product group of the item.
hierarchy.productGroup.name
string
The name of the product group.
hierarchy.productGroup.code
string
The code for the product group.
hierarchy.productGroup.description
string
The full description of the product group.
hierarchy.productGroup.label
string
The abbreviated description of the product group.
hierarchy.productGroup.category
object
The object describing the product category of the item.
hierarchy.productGroup.category.name
string
The name of the product category.
hierarchy.productGroup.category.code
string
The code for the product category.
hierarchy.productGroup.category.description
string
The full description of the product category.
hierarchy.productGroup.category.label
string
The abbreviated description of the product category.
hierarchy.productGroup.category.productType
object
The object describing the product type of the item.
hierarchy.productGroup.category.productType.name
string
The name of the product type.
hierarchy.productGroup.category.productType.code
string
The code for the product type.
hierarchy.productGroup.category.productType.description
string
The full description of the product type.
hierarchy.productGroup.category.productType.label
string
The abbreviated description of the product type.
hierarchy.productGroup.category.productType.materialComposition
object
The object describing the material composition of the item.
hierarchy.productGroup.category.productType.materialComposition.name
string
The name of the material composition.
hierarchy.productGroup.category.productType.materialComposition.code
string
The code for the material composition.
hierarchy.productGroup.category.productType.materialComposition.description
string
The full description of the material composition.
hierarchy.productGroup.category.productType.materialComposition.label
string
The abbreviated description of the material composition.
hierarchy.productGroup.category.productType.materialComposition.warranty
object
The object describing the product warranty for the item.
hierarchy.productGroup.category.productType.materialComposition.warranty.name
string
The name of the warranty.
hierarchy.productGroup.category.productType.materialComposition.warranty.code
string
The code for the warranty.
hierarchy.productGroup.category.productType.materialComposition.warranty.description
string
The full description of the warranty.
hierarchy.productGroup.category.productType.materialComposition.warranty.label
string
The abbreviated description of the warranty.
hierarchy.productGroup.category.productType.materialComposition.brandLine
object
The object describing the brand line of the item.
hierarchy.productGroup.category.productType.materialComposition.brandLine.name
string
The name of the brand line.
hierarchy.productGroup.category.productType.materialComposition.brandLine.code
string
The code for the brand line.
hierarchy.productGroup.category.productType.materialComposition.brandLine.description
string
The full description of the brand line.
hierarchy.productGroup.category.productType.materialComposition.brandLine.label
string
The abbreviated description of the brand line.
branches[]
array
The list of ABC Supply branches with item availability.
branches[].name
string
The ABC Supply branch name.
branches[].number
string
The ABC Supply branch number.
branches[].links
object
The object containing reference links for the ABC Supply branch.
branches[].links.self
string
The API reference link for the ABC Supply branch.
HTTP Status Codes
Name
Type
Description
400
Bad Request
Check the Request to make sure the Request Body and Parameters are passed correctly based on the API documentation.
404
Object Not Found
The request returned empty or no object. Please check the object identifier.