Error codes

It includes application codes explicitly associated with one HTTP status in a public Admin, Storefront, or Auth route.

It is not exhaustive per endpoint: responses originating in dependent services, framework validation, OAuth, or infrastructure are excluded.

1 code was omitted because it is associated with more than one HTTP status; it will not be published until the contract is unambiguous.

Brand

Code	HTTP
`Brand.AlreadyExists`	`409`
`Brand.HasProducts`	`409`
`Brand.NotFound`	`404`

Brands

Code	HTTP
`Brands.ImportSaveFailed`	`500`

Carts

Code	HTTP
`Carts.NotActive`	`400`
`Carts.NotFound`	`404`
`Carts.ReceiptEmpty`	`400`
`Carts.ReceiptInvalidContent`	`400`
`Carts.ReceiptInvalidType`	`400`
`Carts.ReceiptTooLarge`	`400`

Catalog

Code	HTTP
`Catalog.InsufficientStock`	`400`
`Catalog.ProductNotFound`	`404`
`Catalog.SpreadsheetSaveQueueFailed`	`500`
`Catalog.VariantNotFound`	`404`

Code	HTTP
`Categories.DuplicatedIds`	`400`
`Categories.ImportSaveFailed`	`500`
`Categories.InvalidHierarchy`	`400`
`Categories.Mismatch`	`400`
`Categories.NotFound`	`404`
`Categories.PathUpdateFailed`	`400`
`Categories.UpdateFailed`	`400`

Code	HTTP
`Category.HasProducts`	`409`
`Category.HasSubcategories`	`409`
`Category.NotFound`	`404`
`Category.SlugExists`	`409`

Channel

Code	HTTP
`Channel.Forbidden`	`403`
`Channel.NotEnabled`	`400`
`Channel.NotFound`	`404`

Collection

Code	HTTP
`Collection.Exists`	`409`
`Collection.InvalidType`	`400`
`Collection.NotFound`	`404`
`Collection.SlugExists`	`409`

Collections

Code	HTTP
`Collections.ImportSaveFailed`	`500`

Common

Code	HTTP
`Common.BadRequest`	`400`
`Common.Forbidden`	`403`
`Common.NotFound`	`404`

Connector

Code	HTTP
`Connector.Error`	`500`

Customer

Code	HTTP
`Customer.EmailAlreadyExists`	`409`
`Customer.EmailInUse`	`409`
`Customer.NotFound`	`404`

CustomerAddress

Code	HTTP
`CustomerAddress.NotFound`	`404`

CustomerGroup

Code	HTTP
`CustomerGroup.AlreadyExists`	`409`
`CustomerGroup.CustomersNotFound`	`404`
`CustomerGroup.NotFound`	`404`

Customers

Code	HTTP
`Customers.NotFound`	`404`
`Customers.ProfileRequired`	`400`
`Customers.SpreadsheetSaveQueueFailed`	`500`

Export

Code	HTTP
`Export.InvalidFormat`	`400`
`Export.SaveFailed`	`500`

FulfillmentOrders

Code	HTTP
`FulfillmentOrders.NoConnection`	`400`
`FulfillmentOrders.NotFound`	`404`
`FulfillmentOrders.TenantRequired`	`400`
`FulfillmentOrders.UserRequired`	`400`

GetCustomerSpreadsheet

Code	HTTP
`GetCustomerSpreadsheet.NotFound`	`404`

GetOrderSpreadsheet

Code	HTTP
`GetOrderSpreadsheet.NotFound`	`404`

GetProductSpreadsheet

Code	HTTP
`GetProductSpreadsheet.NotFound`	`404`

GetVariantSpreadsheet

Code	HTTP
`GetVariantSpreadsheet.NotFound`	`404`

Holiday

Code	HTTP
`Holiday.NotFound`	`404`

Import

Code	HTTP
`Import.ContentTypeRequired`	`400`
`Import.SaveFailed`	`500`

Inventory

Code	HTTP
`Inventory.AvailableUnderflow`	`400`
`Inventory.Changed`	`409`
`Inventory.ExportSaveFailed`	`500`
`Inventory.ImportSaveFailed`	`500`
`Inventory.NotFound`	`404`
`Inventory.NotTracked`	`409`
`Inventory.OnHandUnderflow`	`400`
`Inventory.StockBatchQueueFailed`	`500`
`Inventory.VariantNotFound`	`404`

Invitation

Code	HTTP
`Invitation.NotFound`	`404`

Listing

Code	HTTP
`Listing.AlreadyExists`	`409`
`Listing.AlreadyPublished`	`400`
`Listing.AlreadyUnpublished`	`400`
`Listing.NotFound`	`404`
`Listing.SyncInvariantFailed`	`500`

Listings

Code	HTTP
`Listings.TooManyProducts`	`400`

Location

Code	HTTP
`Location.CannotDeleteDefault`	`409`
`Location.CodeExists`	`409`
`Location.HasInventory`	`409`
`Location.HasOpenFulfillment`	`409`
`Location.NotFound`	`404`

Locations

Code	HTTP
`Locations.NotFound`	`404`

Member

Code	HTTP
`Member.NotFound`	`404`
`Member.OwnerProtected`	`409`
`Member.SelfDelete`	`409`

Moderation

Code	HTTP
`Moderation.ProductsNotFound`	`404`
`Moderation.SellerNotAllowed`	`403`

ModifierGroup

Code	HTTP
`ModifierGroup.AlreadyExists`	`409`
`ModifierGroup.NotFound`	`404`

ModifierOption

Code	HTTP
`ModifierOption.NotFound`	`400`

Order

Code	HTTP
`Order.NotFound`	`404`

OrderBump

Code	HTTP
`OrderBump.NotFound`	`404`
`OrderBump.VariantNotFound`	`404`

OrderClaim

Code	HTTP
`OrderClaim.NotFound`	`404`

OrderDrafts

Code	HTTP
`OrderDrafts.AuthenticationRequired`	`401`
`OrderDrafts.InvalidShareExpiration`	`400`
`OrderDrafts.InvalidStatus`	`400`
`OrderDrafts.ItemNotFound`	`404`
`OrderDrafts.NotFound`	`404`
`OrderDrafts.ShareNotAvailable`	`404`
`OrderDrafts.ShareNotFound`	`404`
`OrderDrafts.ShareTokenGenerationFailed`	`500`

Orders

Code	HTTP
`Orders.AlreadyExists`	`409`
`Orders.BatchStatus.SaveFailed`	`500`
`Orders.InvalidReturnTransition`	`409`
`Orders.InvoicePermissionRequired`	`403`
`Orders.ItemSpreadsheetSaveQueueFailed`	`500`
`Orders.NotFound`	`404`
`Orders.ReturnCompleted`	`409`

Package

Code	HTTP
`Package.InvalidState`	`400`
`Package.NameExists`	`409`
`Package.NotFound`	`404`

ParentCategory

Code	HTTP
`ParentCategory.NotFound`	`404`

Payments

Code	HTTP
`Payments.ConnectionNotFound`	`404`
`Payments.DuplicateMethod`	`400`
`Payments.MethodNotAvailable`	`400`
`Payments.MethodNotFound`	`400`
`Payments.MethodNotSupported`	`400`
`Payments.MethodProviderNotAllowed`	`400`
`Payments.ProviderMethodCodeNotSupported`	`400`
`Payments.ProviderRequired`	`400`

PickupPoint

Code	HTTP
`PickupPoint.InvalidLocation`	`400`
`PickupPoint.NotFound`	`404`

PriceList

Code	HTTP
`PriceList.InvalidCategory`	`400`
`PriceList.InvalidProduct`	`400`
`PriceList.InvalidVariant`	`400`
`PriceList.NotFound`	`404`

Product

Code	HTTP
`Product.BundleItemsRequired`	`400`
`Product.NotFound`	`404`

ProductReview

Code	HTTP
`ProductReview.AlreadyExists`	`409`
`ProductReview.NotFound`	`404`
`ProductReview.OrderInvalid`	`400`
`ProductReview.OrderOwnerMismatch`	`400`
`ProductReview.ProductNotPurchased`	`400`

Products

Code	HTTP
`Products.BatchDeleteCountMismatch`	`400`
`Products.BatchDeleteSaveFailed`	`500`
`Products.BatchPriceSaveFailed`	`500`
`Products.BatchStatusSaveFailed`	`500`
`Products.ImportOperationNotFound`	`500`
`Products.SpreadsheetSaveQueueFailed`	`500`

Seller

Code	HTTP
`Seller.ContextInvalid`	`403`
`Seller.NotFound`	`404`
`Seller.OwnerEmailRequired`	`400`
`Seller.SlugExists`	`409`
`Seller.SlugInvalid`	`400`
`Seller.StoreTypeInvalid`	`400`

SellerCommission

Code	HTTP
`SellerCommission.DuplicateBrand`	`400`
`SellerCommission.DuplicateCategory`	`400`
`SellerCommission.InvalidBrand`	`400`
`SellerCommission.InvalidCategory`	`400`

Sellers

Code	HTTP
`Sellers.NotFound`	`404`

SellerScope

Code	HTTP
`SellerScope.DuplicateBrand`	`400`
`SellerScope.DuplicateCategory`	`400`
`SellerScope.InvalidBrand`	`400`
`SellerScope.InvalidCategory`	`400`

Shipments

Code	HTTP
`Shipments.ConnectorFailed`	`500`
`Shipments.LabelFailed`	`500`
`Shipments.MultipleFulfillmentOrders`	`400`
`Shipments.NoConnection`	`400`
`Shipments.NoFulfillmentOrder`	`400`
`Shipments.NotFound`	`404`
`Shipments.TrackingFailed`	`500`

Shipping

Code	HTTP
`Shipping.CustomizationNotFound`	`404`
`Shipping.DefaultProfileCannotBeDeleted`	`400`
`Shipping.DisabledForSeller`	`403`
`Shipping.InvalidLocations`	`400`
`Shipping.MethodNotAllowedForSeller`	`403`
`Shipping.ProfileExists`	`409`
`Shipping.ProfileInUseByCustomizations`	`400`
`Shipping.ProfileInUseByMethods`	`400`
`Shipping.ProfileInUseByProducts`	`400`
`Shipping.ProfileNotFound`	`404`
`Shipping.ProfilesDisabledForSeller`	`403`
`Shipping.RateAboveSellerMaximum`	`403`
`Shipping.RateBelowSellerMinimum`	`403`
`Shipping.RatesDisabledForSeller`	`403`
`Shipping.TransitDaysExceeded`	`403`

ShippingMethod

Code	HTTP
`ShippingMethod.InvalidPickupPoints`	`400`
`ShippingMethod.NoConnection`	`400`
`ShippingMethod.NotFound`	`404`

ShippingMethods

Code	HTTP
`ShippingMethods.GroupNotFound`	`400`
`ShippingMethods.GroupRequired`	`400`
`ShippingMethods.InvalidType`	`400`
`ShippingMethods.MethodNotAvailable`	`400`
`ShippingMethods.NameRequired`	`400`
`ShippingMethods.NoShippableItems`	`400`
`ShippingMethods.NotFound`	`404`
`ShippingMethods.OptionAmbiguous`	`400`
`ShippingMethods.OptionNotFound`	`400`
`ShippingMethods.RateMismatch`	`400`
`ShippingMethods.RateNotFound`	`400`
`ShippingMethods.Required`	`400`
`ShippingMethods.SelectorRequired`	`400`

ShippingRate

Code	HTTP
`ShippingRate.NotFound`	`404`

ShippingRates

Code	HTTP
`ShippingRates.ImportAssetNotFound`	`404`
`ShippingRates.ImportInvalidFile`	`400`
`ShippingRates.ImportInvalidHeaders`	`400`
`ShippingRates.ImportInvalidRows`	`400`

ShippingSettings

Code	HTTP
`ShippingSettings.InvalidDefaultLocation`	`400`

ShippingZone

Code	HTTP
`ShippingZone.CodeExists`	`409`
`ShippingZone.NotFound`	`404`

SizeGuide

Code	HTTP
`SizeGuide.Forbidden`	`403`
`SizeGuide.Inactive`	`400`
`SizeGuide.NotFound`	`404`
`SizeGuide.SellerMismatch`	`400`

SizeGuides

Code	HTTP
`SizeGuides.ImportSaveFailed`	`500`

Specification

Code	HTTP
`Specification.HasCategorySpecifications`	`409`
`Specification.InUseByProducts`	`409`
`Specification.InUseByVariants`	`409`
`Specification.NotFound`	`404`
`Specification.SellerNotAllowed`	`403`

Store

Code	HTTP
`Store.AccessContext`	`500`
`Store.AccessDenied`	`401`
`Store.AccessKeyNotConfigured`	`400`
`Store.AccessKeyRequired`	`400`
`Store.CustomerAccountsScopeInvalid`	`400`
`Store.DomainAlreadyExists`	`400`
`Store.DomainHostnameTaken`	`409`
`Store.DomainInvalid`	`400`
`Store.DomainNotFound`	`404`
`Store.DomainSetupFailed`	`400`
`Store.NotFound`	`404`
`Store.SlugExists`	`409`
`Store.SlugInvalid`	`400`

TaxOverride

Code	HTTP
`TaxOverride.NotFound`	`404`

TaxRegion

Code	HTTP
`TaxRegion.AlreadyExists`	`409`
`TaxRegion.CountryExists`	`409`
`TaxRegion.NotFound`	`404`

Template

Code	HTTP
`Template.DraftExists`	`409`
`Template.Invalid`	`400`
`Template.NotDraft`	`409`
`Template.NotFound`	`404`

Tenant

Code	HTTP
`Tenant.Invalid`	`400`

User

Code	HTTP
`User.NotAuthenticated`	`401`

Variant

Code	HTTP
`Variant.NotFound`	`404`

VariantSpreadsheet

Code	HTTP
`VariantSpreadsheet.LocationNotFound`	`404`

WebhookEndpoint

Code	HTTP
`WebhookEndpoint.NotFound`	`404`
`WebhookEndpoint.UrlExists`	`409`

Webhooks

Code	HTTP
`Webhooks.DeliveryNotFound`	`404`
`Webhooks.DeliveryNotRetryable`	`409`
`Webhooks.DeliveryPayloadMissing`	`409`
`Webhooks.EndpointNotFound`	`404`

Error codes

On this page