MasonHub ERP Integration home pagelight logo
  1. Catalog
  2. Get SKUs
GET
/skus
curl --request GET \
     --url https://sandbox.masonhub.co/dragonfly-cosmetics-demo/api/v1/skus \
     --header 'Authorization: Bearer <token>'

The Catalog API manages SKUs (Stock Keeping Units), which are the primary catalog items in the MasonHub system. SKUs provide comprehensive product information and support complex scenarios like kits, multiple barcodes, and special handling requirements.

SKUs are the primary catalog items in MasonHub. They are never fully removed from the system if inventory exists, ensuring data integrity and historical tracking.

This endpoint allows you to query your catalog by MasonHub UUIDs, customer identifiers, or retrieve paginated lists of all SKUs.

​
Query Parameters

id
UUID[]

MasonHub UUID strings. Supports batching 1-30 IDs per request.

cid
string[]

Customer identifiers. Supports batching 1-30 identifiers per request.

list_type
default:detail
string

Response detail level. Options:

  • detail - Full SKU information including all fields
  • summary - Condensed view with essential fields only
limit
default:30
integer

Number of results to return. Range: 1-100.

offset
default:0
integer

Pagination offset for retrieving subsequent pages of results.

include_counts
default:false
boolean

Include inventory counts in the response. Only applies when list_type=detail.

curl -X GET "https://app.masonhub.co/{account}/api/v1/skus?cid=pants4523&list_type=detail&include_counts=true" \
  -H "Authorization: Bearer your_jwt_token"

{
  "include_counts": true,
  "limit": 10,
  "list_type": "detail", 
  "offset": 0,
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "customer_identifier": "pants4523",
      "customer_bar_code": "2345687902",
      "vendor_bar_code": "39485627389",
      "bar_codes": ["85962198623", "3459189485324"],
      "vendor_style": "FP-pants",
      "brand_name": "Freddie's Pants",
      "product_name": "Fancy Pants",
      "product_category": "Apparel",
      "product_sub_category": "pants",
      "product_description": "Very fancy pants with stripes",
      "dim_weight": 0.75,
      "dim_length": 4,
      "dim_width": 2.2,
      "dim_height": 0.5,
      "unit_cost": 80,
      "price": 160,
      "available_quantity": 150,
      "allocated_quantity": 25
    }
  ]
}

​
Batch Queries

You can query multiple SKUs in a single request using arrays:

# Query by multiple customer identifiers
GET /skus?cid=pants4523&cid=shirts450293&cid=hat001

# Query by multiple MasonHub UUIDs
GET /skus?id=550e8400-e29b-41d4-a716-446655440000&id=660f9500-f30c-52e5-b827-557766551111

Maximum 30 identifiers per batch request. Exceeding this limit will result in a 400 error.

​
Performance Tips

Use Summary Lists

Start with list_type=summary when browsing or building selection UIs.

Filter Specifically

Use cid or id arrays for targeted retrieval instead of paginating through all SKUs.

Appropriate Limits

Use reasonable limit values to avoid timeouts on large catalogs.

Include Counts Sparingly

Only use include_counts=true when inventory data is actually needed.