1. Enriched Catalog
  • Introduction to our API
    • Overview
    • Getting Started
    • Product Catalog
    • Webhooks Overview
    • Notifications Guide
  • User
    • Client
      • Generate Service Client Access Token
    • User
      • Login User by Username and Password
      • Login User with Refresh Token
  • Order
    • OrderItems
      • Search for order items based on various criteria and filters
    • Orders
      • Create a New Order.
      • Search for orders based on various criteria and filters.
      • Create multiple orders
      • Retrieve multiple orders
      • Update multiple orders
      • Retrieve a list of orders
      • Retrieve an order by Order ID.
      • Update order data.
      • Retrieve an order by Safe ID
      • Retrieve order item by Order Item ID
      • Update an item within an order.
      • Cancel Order or order items
      • Change the order status to Customer Care Hold
      • Retrieve audit logs for a specific order.
      • Retrieve audit logs for a specific order.
      • Retrieve audit logs for a specific order item.
      • Add a Refund Request.
  • Note
    • Notes
      • Create a New Note
      • Search All Notes
      • View Note by ID
      • Update Note
      • Delete Note
      • View Note Audit Logs
  • Catalog
    • Categories
      • View all product categories
      • Create a new category
      • Update category
      • Delete category
      • Get audit logs of a category
    • MerchantCatalog
      • Create a merchant catalog
      • Update a merchant catalog
      • Partially update a merchant catalog
      • Get a list of merchant catalogs
      • Delete a merchant catalog
      • Get a merchant catalog and search variants in it
      • Get a merchant catalog with variants
      • Get a list of variants the merchant can use in accordance with their enabled catalog
      • Search for variants in enabled merchant catalog with fallback to global catalog
      • Get the variants of the merchant's custom catalog with their stored and live global attributes
      • Search the variants of the merchant's custom catalog, with their stored and live global attributes
      • Get audit logs of a merchant catalog
      • Get the products of the merchant's custom catalog with live global product data
      • Search the products of the merchant's custom catalog, with live global product data
    • Products
      • View all products
      • Retrieve product variant details
      • Create a new product
      • Search products
      • Bulk create products
      • Bulk update products
      • Update product
      • Delete product
      • Update variant
      • Get audit logs of a product
    • Variants
      • Delete variant
      • Create a variant
      • Search product variants
      • Get audit logs of a variant
      • Search product variants with cursor pagination
    • MerchantVariants
      • Add new variants to a merchant catalog
      • Update a merchant catalog variants
      • Update a merchant catalog by removing variants
    • Enriched Catalog
      • List the vendors a merchant is connected to.
        GET
      • Page through the vendor product data of every vendor a merchant is connected to.
        GET
      • Get every variation of one product, per connected vendor able to produce it.
        GET
  • Shipment
    • Packing Slip
      • Generates a packing slip for a specific shipment by Shipment ID.
    • Shipments
      • Get details of a specific shipment by Shipment ID.
      • Update details of a specific shipment by Shipment ID.
      • Create packages for a specific shipment.
      • Delete shipment with packages.
      • Get all shipments for an order by Order ID.
      • Create shipment for order, vendor, and order items.
      • Get shipment with packages for order and vendor.
      • Get shipment details by Order Item ID.
      • Update a specific shipment package.
      • Delete a specific shipment package.
      • Cancel shipment.
      • Unassign items to shipment.
      • Shipment resubmission to assigned facility.
      • Retry outbound polling for a shipment by publishing an OutboundShipmentUpdate event.
      • Search shipments.
      • Reroute shipment.
      • Rejects a shipment.
      • Bulk reroute shipments.
      • Get shipment audit logs.
      • Get package audit logs.
      • Get message audit logs for shipment updates.
      • Assign Shipment.
    • VendorShipments
      • Get full vendor details for up to 100 shipments in a single call. Only available for vendor and admin users. Returns a per-id result for each requested shipment: accessible shipments return a 200 detail model, missing ids return 404, and inaccessible ids
  1. Enriched Catalog

Page through the vendor product data of every vendor a merchant is connected to.

GET
/v1/enrichedCatalog
Vendor Access: Forbidden — This endpoint is not accessible to vendor users.
Returns what each connected vendor specifies for the products the merchant can order from it: attributes, and
per facility the availability, production time, decorations and image specs. Each vendor is served from the
merchant's own overrides when it has any for that vendor, else its parent's, else the vendor's catalog
(source, overrideMerchantId); any override for a vendor replaces that vendor's whole catalog.
facilities lists each facility the page references once, with its VAS options and the shipping mappings
fulfillment would use for this merchant. Entries are sorted by vendor (by label for a redacted sub-account), then
SKU. Filters combine: vendorId
(a connected vendor, or its label for a redacted sub-account; 404 otherwise), skus (up to 50) and
productId (400 when the product does not exist). Vendor SKUs, costs, addresses and contacts are never
returned. A redacted sub-account sees vendor and location labels and no template links. Returns 404 while the
feature is not enabled for the merchant and an empty page when it has no connections. To walk a whole catalog,
pass useCursor=true: every page then costs the same however deep it is, page is ignored, and each
response's nextCursor continues the walk until it comes back empty. A cursor only works with the filters it
was issued for.

Request

Query Params

Responses

🟢200
application/json
OK
Body

🟠400
🟠401
🟠403
🟠404
🟠409
🔴500
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.ordermesh.io/catalog/v1/enrichedCatalog?merchantId=&vendorId=&skus=&productId=&page=&pageSize=&useCursor=&cursor='
Response Response Example
200 - Success
{
    "items": [
        {
            "merchantId": "681abd18c61bccfab89bc63e",
            "vendorId": "V00001234",
            "vendorName": "Acme Print",
            "sku": "TEE-BLK-M",
            "variantId": "68a1f0c2e4b0a1c3d5e7f901",
            "productId": "68a1f0a7e4b0a1c3d5e7f8aa",
            "source": "DEFAULT",
            "overrideMerchantId": null,
            "attributes": [
                {
                    "name": "Color",
                    "value": "Black"
                },
                {
                    "name": "Size",
                    "value": "M"
                }
            ],
            "production": [
                {
                    "facilityId": "F00000042",
                    "availability": "AVAILABLE",
                    "productionTimeDays": 3,
                    "decorations": [
                        {
                            "printMethod": "DTG",
                            "area": "Front",
                            "vendorArea": "front_center",
                            "attributes": [
                                {
                                    "name": "InkType",
                                    "value": "WaterBased"
                                }
                            ],
                            "imageSpecs": {
                                "width": 4500,
                                "height": 5400,
                                "dpi": 300,
                                "allowedFormats": [
                                    "png"
                                ],
                                "orientationImportant": true,
                                "numberOfImages": 1,
                                "maxFileSizeInMiB": 50
                            },
                            "templateUrl": "https://vendor.example/templates/tee-front.png"
                        }
                    ]
                }
            ]
        }
    ],
    "facilities": [
        {
            "facilityId": "F00000042",
            "vendorId": "V00001234",
            "name": "Acme Dallas",
            "vasOptions": [
                "NeckTag",
                "PackSlips"
            ],
            "shippingMappingsSource": "VENDOR",
            "shippingMappings": [
                {
                    "carrierName": "UPS",
                    "type": "DETAILED",
                    "shippingMethods": [
                        {
                            "shipmentMethod": "Standard",
                            "vendorShippingMethod": "GND",
                            "carrierShippingServiceMethods": [
                                {
                                    "serviceMethodsAllowed": [
                                        "Ground"
                                    ],
                                    "countryCodesToApply": [
                                        "US",
                                        "CA"
                                    ],
                                    "vendorMapping": {
                                        "carrierCode": "UPS",
                                        "serviceCode": "03"
                                    }
                                }
                            ]
                        }
                    ]
                }
            ],
            "shippingGroupMappings": []
        }
    ],
    "page": 1,
    "pageSize": 25,
    "totalCount": 1,
    "totalPages": 1,
    "hasNextPage": false,
    "hasPreviousPage": false,
    "nextCursor": ""
}
Modified at 2026-10-23 15:21:26
Previous
List the vendors a merchant is connected to.
Next
Get every variation of one product, per connected vendor able to produce it.
Built with