B2B REST APIs for Acuity Brands distributors covering inventory availability, order status tracking, product catalog, and web content. Enables integration of Acuity Brands data into distributor ERP, e-commerce, and ordering systems.
{
"openapi": "3.1.0",
"info": {
"title": "Acuity Brands API",
"description": "B2B REST APIs for Acuity Brands distributors covering inventory availability, order status tracking, product catalog, and web content. Enables integration of Acuity Brands data into distributor ERP, e-commerce, and ordering systems.",
"version": "1.0.0",
"contact": {
"name": "Acuity Brands Developer Portal",
"url": "https://api-docs.acuitybrands.com/"
}
},
"servers": [
{
"url": "https://api.acuitybrands.com/v1",
"description": "Acuity Brands production API"
}
],
"tags": [
{"name": "Inventory", "description": "Product inventory and availability"},
{"name": "Orders", "description": "Order status and shipment tracking"},
{"name": "Catalog", "description": "Product catalog and item details"},
{"name": "Webpages", "description": "Web content and product page data"}
],
"paths": {
"/inventory": {
"get": {
"operationId": "listInventory",
"summary": "Acuity Brands List Inventory",
"description": "Retrieve inventory availability for Acuity Brands products. Returns stock levels, warehouse locations, and estimated availability dates.",
"tags": ["Inventory"],
"parameters": [
{
"name": "productNumber",
"in": "query",
"description": "Filter by Acuity Brands product number",
"schema": {"type": "string"}
},
{
"name": "brand",
"in": "query",
"description": "Filter by brand (e.g. Lithonia, Holophane, nLight)",
"schema": {"type": "string"}
},
{
"name": "warehouse",
"in": "query",
"description": "Filter by warehouse location code",
"schema": {"type": "string"}
},
{
"name": "limit",
"in": "query",
"description": "Maximum number of results to return",
"schema": {"type": "integer", "default": 100}
},
{
"name": "cursor",
"in": "query",
"description": "Pagination cursor for next page",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Inventory list",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/InventoryList"}
}
}
},
"401": {"description": "Unauthorized — invalid or missing API credentials"}
}
}
},
"/inventory/{productNumber}": {
"get": {
"operationId": "getInventoryItem",
"summary": "Acuity Brands Get Inventory Item",
"description": "Retrieve inventory availability for a specific product number including stock by warehouse and estimated ship dates.",
"tags": ["Inventory"],
"parameters": [
{
"name": "productNumber",
"in": "path",
"required": true,
"description": "Acuity Brands product number",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Inventory item details",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/InventoryItem"}
}
}
},
"401": {"description": "Unauthorized"},
"404": {"description": "Product not found"}
}
}
},
"/orders": {
"get": {
"operationId": "listOrders",
"summary": "Acuity Brands List Orders",
"description": "Retrieve a list of orders with their current status, estimated ship dates, and tracking information.",
"tags": ["Orders"],
"parameters": [
{
"name": "status",
"in": "query",
"description": "Filter by order status (pending, processing, shipped, delivered)",
"schema": {"type": "string", "enum": ["pending", "processing", "shipped", "delivered"]}
},
{
"name": "fromDate",
"in": "query",
"description": "Filter orders placed on or after this date (ISO 8601)",
"schema": {"type": "string", "format": "date"}
},
{
"name": "toDate",
"in": "query",
"description": "Filter orders placed on or before this date (ISO 8601)",
"schema": {"type": "string", "format": "date"}
},
{
"name": "limit",
"in": "query",
"description": "Maximum number of results",
"schema": {"type": "integer", "default": 50}
},
{
"name": "cursor",
"in": "query",
"description": "Pagination cursor",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Order list",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/OrderList"}
}
}
},
"401": {"description": "Unauthorized"}
}
}
},
"/orders/{orderId}": {
"get": {
"operationId": "getOrder",
"summary": "Acuity Brands Get Order",
"description": "Retrieve full order status details including line items, estimated ship dates, actual shipment dates, carrier, and pro number.",
"tags": ["Orders"],
"parameters": [
{
"name": "orderId",
"in": "path",
"required": true,
"description": "Acuity Brands order identifier",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Order details",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/Order"}
}
}
},
"401": {"description": "Unauthorized"},
"404": {"description": "Order not found"}
}
}
},
"/orders/{orderId}/shipments": {
"get": {
"operationId": "getOrderShipments",
"summary": "Acuity Brands Get Order Shipments",
"description": "Retrieve all shipment records for an order including carrier, pro number, and tracking URLs.",
"tags": ["Orders"],
"parameters": [
{
"name": "orderId",
"in": "path",
"required": true,
"description": "Acuity Brands order identifier",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Shipment list for order",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/ShipmentList"}
}
}
},
"401": {"description": "Unauthorized"},
"404": {"description": "Order not found"}
}
}
},
"/catalog/items": {
"get": {
"operationId": "listCatalogItems",
"summary": "Acuity Brands List Catalog Items",
"description": "Search the Acuity Brands product catalog by category, brand, or keyword. Returns product details, specifications, and pricing.",
"tags": ["Catalog"],
"parameters": [
{
"name": "q",
"in": "query",
"description": "Keyword search query",
"schema": {"type": "string"}
},
{
"name": "brand",
"in": "query",
"description": "Filter by brand name",
"schema": {"type": "string"}
},
{
"name": "category",
"in": "query",
"description": "Product category (indoor-lighting, outdoor-lighting, controls, emergency)",
"schema": {"type": "string"}
},
{
"name": "limit",
"in": "query",
"description": "Maximum number of results",
"schema": {"type": "integer", "default": 50}
},
{
"name": "cursor",
"in": "query",
"description": "Pagination cursor",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Catalog item list",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/CatalogItemList"}
}
}
},
"401": {"description": "Unauthorized"}
}
}
},
"/catalog/items/{productNumber}": {
"get": {
"operationId": "getCatalogItem",
"summary": "Acuity Brands Get Catalog Item",
"description": "Retrieve detailed product information for a specific item including specifications, certifications, and pricing.",
"tags": ["Catalog"],
"parameters": [
{
"name": "productNumber",
"in": "path",
"required": true,
"description": "Product number or SKU",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Catalog item details",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/CatalogItem"}
}
}
},
"401": {"description": "Unauthorized"},
"404": {"description": "Product not found"}
}
}
},
"/webpages": {
"get": {
"operationId": "listWebpages",
"summary": "Acuity Brands List Webpages",
"description": "Retrieve product and content web pages from Acuity Brands including page URLs, metadata, and content structure.",
"tags": ["Webpages"],
"parameters": [
{
"name": "type",
"in": "query",
"description": "Page type filter (product, category, landing)",
"schema": {"type": "string"}
},
{
"name": "brand",
"in": "query",
"description": "Filter by brand",
"schema": {"type": "string"}
},
{
"name": "limit",
"in": "query",
"description": "Maximum number of results",
"schema": {"type": "integer", "default": 50}
},
{
"name": "cursor",
"in": "query",
"description": "Pagination cursor",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Webpage list",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/WebpageList"}
}
}
},
"401": {"description": "Unauthorized"}
}
}
},
"/webpages/{pageId}": {
"get": {
"operationId": "getWebpage",
"summary": "Acuity Brands Get Webpage",
"description": "Retrieve full content and metadata for a specific Acuity Brands web page.",
"tags": ["Webpages"],
"parameters": [
{
"name": "pageId",
"in": "path",
"required": true,
"description": "Page identifier",
"schema": {"type": "string"}
}
],
"responses": {
"200": {
"description": "Webpage details",
"content": {
"application/json": {
"schema": {"$ref": "#/components/schemas/Webpage"}
}
}
},
"401": {"description": "Unauthorized"},
"404": {"description": "Page not found"}
}
}
}
},
"components": {
"securitySchemes": {
"BasicAuth": {
"type": "http",
"scheme": "basic",
"description": "HTTP Basic Auth using numeric User ID as username and API Key as password"
}
},
"schemas": {
"InventoryItem": {
"type": "object",
"description": "Inventory availability record for a product",
"properties": {
"productNumber": {"type": "string", "description": "Acuity Brands product number", "example": "LBL4 48L ADP"},
"description": {"type": "string", "description": "Product description", "example": "4FT LED Wrap Light 4800 Lumens"},
"brand": {"type": "string", "description": "Brand name", "example": "Lithonia Lighting"},
"totalQuantity": {"type": "integer", "description": "Total available quantity across all warehouses", "example": 250},
"warehouses": {
"type": "array",
"description": "Per-warehouse availability",
"items": {
"type": "object",
"properties": {
"code": {"type": "string", "example": "ATL"},
"name": {"type": "string", "example": "Atlanta Distribution Center"},
"quantity": {"type": "integer", "example": 150},
"estimatedShipDate": {"type": "string", "format": "date", "example": "2026-04-22"}
}
}
},
"updatedAt": {"type": "string", "format": "date-time", "description": "Last inventory update time"}
}
},
"InventoryList": {
"type": "object",
"description": "Paginated list of inventory items",
"properties": {
"items": {"type": "array", "items": {"$ref": "#/components/schemas/InventoryItem"}},
"total": {"type": "integer", "example": 5000},
"cursor": {"type": "string", "example": "eyJwYWdlIjoyfQ=="}
}
},
"Order": {
"type": "object",
"description": "An Acuity Brands order with status and shipment information",
"properties": {
"orderId": {"type": "string", "description": "Acuity Brands order number", "example": "ACB-2026-001234"},
"purchaseOrderNumber": {"type": "string", "description": "Distributor purchase order number", "example": "PO-55678"},
"status": {"type": "string", "enum": ["pending", "processing", "shipped", "delivered", "cancelled"], "example": "shipped"},
"orderDate": {"type": "string", "format": "date", "description": "Date order was placed", "example": "2026-04-15"},
"estimatedShipDate": {"type": "string", "format": "date", "description": "Estimated ship date", "example": "2026-04-20"},
"actualShipDate": {"type": "string", "format": "date", "description": "Actual ship date", "example": "2026-04-19"},
"lineItems": {
"type": "array",
"description": "Order line items",
"items": {
"type": "object",
"properties": {
"lineNumber": {"type": "integer", "example": 1},
"productNumber": {"type": "string", "example": "LBL4 48L ADP"},
"description": {"type": "string", "example": "4FT LED Wrap Light"},
"quantity": {"type": "integer", "example": 10},
"unitPrice": {"type": "number", "example": 45.50},
"status": {"type": "string", "example": "shipped"}
}
}
},
"totalAmount": {"type": "number", "description": "Total order amount", "example": 455.00},
"shipToAddress": {
"type": "object",
"properties": {
"name": {"type": "string", "example": "ABC Electrical Distributors"},
"street": {"type": "string", "example": "123 Main St"},
"city": {"type": "string", "example": "Atlanta"},
"state": {"type": "string", "example": "GA"},
"zip": {"type": "string", "example": "30301"}
}
}
}
},
"OrderList": {
"type": "object",
"description": "Paginated list of orders",
"properties": {
"orders": {"type": "array", "items": {"$ref": "#/components/schemas/Order"}},
"total": {"type": "integer", "example": 200},
"cursor": {"type": "string"}
}
},
"Shipment": {
"type": "object",
"description": "Shipment record for an order",
"properties": {
"shipmentId": {"type": "string", "description": "Shipment identifier", "example": "SHP-001"},
"orderId": {"type": "string", "description": "Associated order ID", "example": "ACB-2026-001234"},
"carrier": {"type": "string", "description": "Shipping carrier name", "example": "UPS Freight"},
"proNumber": {"type": "string", "description": "Carrier PRO/tracking number", "example": "1Z999AA10123456784"},
"trackingUrl": {"type": "string", "description": "Carrier tracking URL", "example": "https://www.ups.com/track?tracknum=1Z999AA10123456784"},
"shipDate": {"type": "string", "format": "date", "example": "2026-04-19"},
"estimatedDeliveryDate": {"type": "string", "format": "date", "example": "2026-04-22"},
"weight": {"type": "number", "description": "Shipment weight in lbs", "example": 45.5},
"lineItems": {
"type": "array",
"description": "Line items in this shipment",
"items": {
"type": "object",
"properties": {
"lineNumber": {"type": "integer", "example": 1},
"productNumber": {"type": "string", "example": "LBL4 48L ADP"},
"quantityShipped": {"type": "integer", "example": 10}
}
}
}
}
},
"ShipmentList": {
"type": "object",
"description": "List of shipments for an order",
"properties": {
"shipments": {"type": "array", "items": {"$ref": "#/components/schemas/Shipment"}},
"total": {"type": "integer", "example": 2}
}
},
"CatalogItem": {
"type": "object",
"description": "Acuity Brands product catalog item",
"properties": {
"productNumber": {"type": "string", "description": "Product number/SKU", "example": "LBL4 48L ADP"},
"name": {"type": "string", "description": "Product name", "example": "4FT LED Wrap Light 4800 Lumens Adapter"},
"brand": {"type": "string", "description": "Brand name", "example": "Lithonia Lighting"},
"category": {"type": "string", "description": "Product category", "example": "Indoor Lighting"},
"subcategory": {"type": "string", "description": "Product subcategory", "example": "Wrap Lights"},
"description": {"type": "string", "description": "Full product description"},
"specifications": {
"type": "object",
"description": "Technical specifications",
"additionalProperties": true
},
"certifications": {"type": "array", "items": {"type": "string"}, "description": "Product certifications", "example": ["UL Listed", "Energy Star", "DLC Listed"]},
"listPrice": {"type": "number", "description": "List price in USD", "example": 89.99},
"upc": {"type": "string", "description": "UPC code", "example": "041194682000"},
"imageUrl": {"type": "string", "description": "Primary product image URL"},
"dataSheetUrl": {"type": "string", "description": "Product data sheet URL"}
}
},
"CatalogItemList": {
"type": "object",
"description": "Paginated list of catalog items",
"properties": {
"items": {"type": "array", "items": {"$ref": "#/components/schemas/CatalogItem"}},
"total": {"type": "integer", "example": 50000},
"cursor": {"type": "string"}
}
},
"Webpage": {
"type": "object",
"description": "Acuity Brands product or content web page",
"properties": {
"pageId": {"type": "string", "description": "Page identifier", "example": "lithonia-lbl4"},
"url": {"type": "string", "description": "Canonical page URL", "example": "https://www.acuitybrands.com/products/lbl4"},
"title": {"type": "string", "description": "Page title", "example": "LBL4 LED Wrap Light"},
"type": {"type": "string", "enum": ["product", "category", "landing", "support"], "description": "Page type", "example": "product"},
"brand": {"type": "string", "description": "Associated brand", "example": "Lithonia Lighting"},
"metaDescription": {"type": "string", "description": "SEO meta description"},
"productNumber": {"type": "string", "description": "Associated product number if product page", "example": "LBL4 48L ADP"},
"lastModified": {"type": "string", "format": "date-time", "description": "Page last modified timestamp"}
}
},
"WebpageList": {
"type": "object",
"description": "Paginated list of web pages",
"properties": {
"pages": {"type": "array", "items": {"$ref": "#/components/schemas/Webpage"}},
"total": {"type": "integer", "example": 10000},
"cursor": {"type": "string"}
}
}
}
},
"security": [
{"BasicAuth": []}
]
}