Location API
Find an ABC Supply location by city, state, longitude and latitude, and other criteria. View geography hierarchies and key branch attributes such as products and services offered, branch hours and contacts.
The Get Branch endpoint returns detailed branch information for a specific branch by account number. Branch details returned include contact information, manager details, hours of operation, products, services, branch website link, and nearby branches.
Location API
Get Branch
GET /branches/{branchnumber}
Get ABC Supply branch information by branch number
Sandbox
Production
Authorization
OAuth 2.0 server or user token with the location.read scope.
Request
Query Parameters
The URI parameter “{branchNumber}” is the branch number to search.
Example Request
Get Branch request for a provided branch number
GET /api/location/v1/branches/409 HTTP/1.1
Host: partner.abcsupply.com
Authorization: Bearer <TOKEN>Response
Example Response
Response for a given branch.
{
"branch": {
"number": "409",
"name": "ABC Supply Company - Hyattsville, MD",
"storefront": "abc",
"status": "open",
"type": "Branch"
},
"address": {
"addressLine1": "3404 Kenilworth Ave",
"addressLine2": null,
"addressLine3": null,
"city": "Hyattsville",
"state": "MD",
"postal": "20781-1008",
"country": "USA"
},
"locale": {
"lat": "38.9311",
"long": "-76.9336",
"timeZoneCode": "ET",
"timeZoneDescription": "America/New_York"
},
"contact": {
"phones": [
"3012777711",
"3016999341"
],
"emails": [
"[email protected]"
],
"fax": "3016999341"
},
"manager": {
"firstName": "John",
"lastName": "Doe",
"email": "[email protected]",
"title": "ABC Branch Manager",
"pictureUrl": null
},
"hoursOfOperation": [
{
"type": "Branch Hours",
"days": "Mon - Fri",
"open": "07:00",
"close": "16:00",
"notes": "Weekday Hours"
},
{
"type": "Branch Hours",
"days": "Sat",
"open": "07:00",
"close": "11:00",
"notes": "Weekend Hours"
}
],
"products": [
{
"productGroup": {
"name": "Roofing Insulation",
"description": "Roofing Insulation"
},
"categories": [
{
"name": "Roofing Insulation",
"description": "Roofing Insulation"
}
]
},
{
"productGroup": {
"name": "Steep Slope Roofing",
"description": "Steep Slope Roofing"
},
"categories": [
{
"name": "Metal Roofing",
"description": "Metal Roofing"
},
{
"name": "Asphalt Shingles",
"description": "Asphalt Shingles"
}
]
}
],
"services": [
{
"type": "local",
"name": "Local Services",
"value": [
"EPDM Cut-To-Length",
"Next-Day Delivery Available",
"Steep-Slope Take-Off Assistance",
"Express Pickup"
]
},
{
"type": "national",
"name": "National Services",
"value": [
"Free Tapered Take-Offs"
]
}
],
"links": {
"website": "https://www.abcsupply.com/locations/location/?id=409"
},
"nearByBranches": [
{
"number": "240",
"name": "ABC Supply Company - Cheverly, MD",
"storefront": "abc",
"distance": 1.69991449931755,
"status": "open",
"links": {
"self": "https://partners-sb.abcsupply.com/api/location/v1/branches/240",
"website": "https://www.abcsupply.com/locations/location/?id=240"
}
},
{
"number": "379",
"name": "ABC Supply Company - Baltimore, MD",
"storefront": "abc",
"distance": 23.6896651772705,
"status": "open",
"links": {
"self": "https://partners-sb.abcsupply.com/api/location/v1/branches/379",
"website": "https://www.abcsupply.com/locations/location/?id=379"
}
}
]
}Name
Type
Description
branch
object
The object describing the branch.
branch.number
string
The unique branch number.
branch.name
string
The branch name., including the city and state.
branch.storefront
string
The storefront or branding of the branch (e.g., “abc”, “lw”, “tci”). ABC Supply is the only storefront supported at this time.
branch.status
string
The current operational status of the branch (e.g., “open”, “closed”).
branch.type
string
The type of the branch (e.g., “Branch”).
address
object
The object describing the address of the branch.
address.addressLine1
string
The first line of the branch’s address including the street number and street name.
address.addressLine2
string
The second line of the branch’s address, which may include additional information like building numbers.
address.addressLine3
string
The third line of the branch’s address, often used for more specific location information or additional directions.
address.city
string
The city where the branch is located.
address.state
string
The two-letter state abbreviation code where the branch is located (e.g., “WI”, “IL”).
address.postal
string
The postal or zip code of the branch.
address.country
string
The three-letter ISO 3166-1 country code where the branch is located (e.g.. “USA”). “USA” is the only country code supported at this time.
locale
object
The object containing information about the branch geographical location and time zone.
locale.lat
string
The latitude of the branch location.
locale.long
string
The longitude of the branch location.
locale.timeZoneCode
string
The two-letter time zone abbreviation where the branch is located (e.g.. “PT”, “CT”, “ET”).
locale.timeZoneDescription
string
The canonical time zone identifier as maintained by ICANN (e.g. “America/New York”).
contact
object
The object describing the branch contacts.
contact.phones[]
array
The list of branch phone numbers with extensions, if applicable.
contact.emails[]
array
The email addresses of branch contacts.
contact.fax
string
The branch fax number.
manager
object
The object that describes the branch manager information.
manager.firstName
string
The first name of the branch manager.
manager.lastName
string
The last name of the branch manager.
manager.email
string
The email address of the branch manager.
manager.title
string
The title or role held by the branch manager (e.g., “Branch Manager”, “Managing Partner”).
manager.pictureUrl
string
The URL of the branch manager’s profile image.
hoursOfOperation
array
The list of the hours of operation of the branch.
hoursOfOperation[].type
string
The type of hours operation or service (e.g., “DAILY”, “WEEKEND”, “OFF_HOURS”).
hoursOfOperation[].days
string
The abbreviated day name when the branch is open or operational (e.g., “MON – FRI”, “SAT”, “SUN”).
hoursOfOperation[].open
string
The opening time of the branch.
hoursOfOperation[].close
string
The closing time of the branch.
hoursOfOperation[].notes
string
The additional notes or information about the branch hours of operation.
products
array
The list of the information about products offered by the branch.
products[].productGroup
object
The object describing the product group.
products[].productGroup.name
string
The name of the product group.
products[].productGroup.description
string
The description of the product group.
products[].categories
array
The list of the information about product categories offered by the branch.
products[].categories[].name
string
The name of the product category.
products[].categories[].description
string
The description of the product category.
services
array
The list of information for services offered by the branch.
services[].type
string
The type of service (e.g., “local”, “national”).
services[].name
string
The name of the service.
services[].value[]
array
The list of specific services offered at the branch (e.g. , “Express Pickup”, “Rooftop Delivery”, “Cut-to-length Gutter Coil”, “Two man roof load”).
links
object
The object describing reference links for the branch.
nearByBranches
array
The list of information about the nearest branch location.
nearByBranches[].number
string
The unique branch number.
nearByBranches[].name
string
The branch name., including the city and state.
nearByBranches[].storefront
string
The storefront or branding of the branch (e.g., “abc”, “lw”, “tci”). ABC Supply is the only storefront supported at this time.
nearByBranches[].distance
float
The distance in miles between the requested branch and the nearby branch.
nearByBranches[].status
string
The current operational status of the branch (e.g., “open”, “closed”).
nearByBranches[].links
object
The object describing reference links for the nearby branch.
nearByBranches[].links.self
string
The API reference link for the branch.
HTTP Status Codes
Code
Status
Description
200
OK
The request and response were successfully sent.
400
Bad Request
Confirm the request body and parameters are formatted correctly.
404
Not Found
No branches were found with the parameters provided in the request.