REST API error codes
Find the full list of REST API error codes in the tables below.
General REST API errors
WRONG_PARAMETER
400
Wrong request parameter.
INCORRECT_IMAGE_SIZE
400
Incorrect image size (more than 20 MB).
NOT_AVAILABLE_ON_CURRENT_PLAN
402
Feature not available on current plan
STORE_IS_SUSPENDED
402
Store with specified ID is currently suspended. Learn more about store suspension in Help Center.
STORE_NOT_FOUND
404
Store with specified ID was not found.
PROFILE_NOT_FOUND
404
User store profile not found.
ORDER_NOT_FOUND
404
Order with specified ID was not found.
CHECKOUT_NOT_FOUND
404
Checkout with specified ID was not found.
METHOD_NOT_ALLOWED
405
HTTP request type is not supperted for the specified endpoint.
TIMEOUT
408
Request failed due to timeout.
RATE_LIMITED
429
Too many requests, rate limit exceeded. Access token of the app will be temporarily blocked.
EXTERNAL_ID_ALREADY_USED
409
Entity with this external ID already exists in the store.
LANGUAGES_NOT_ALLOWED
400
Specified languages are disabled in the store.
WRONG_URL
422
Wrong URL provided
MULTILINGUAL_STORE_FEATURE_NOT_ACTIVE
400
Can't add translation due to multilingual feature being disabled in the store.
Products/categories
MAX_PRODUCTS_FOR_API_REQUEST_LIMIT_EXCEEDED
402
Too many products in the product update/create request (more than 100).
MAX_CATEGORIES_FOR_API_REQUEST_LIMIT_EXCEEDED
402
Too many categories in the product update/create request (more than 100).
COMBINATION_LIMIT_PER_REQUEST_EXCEEDED
400
Too many product variations in the product update/create request (more than 200).
PRODUCT_NOT_FOUND
404
Product with specified ID was not found.
COMBINATION_NOT_FOUND
404
Product combination with specified ID was not found.
CATEGORIES_NOT_FOUND
404
Categories with specified IDs were not found.
SKU_ALREADY_EXISTS
409
Produuct with specified SKU already exists. This error only appears for stores with disabled "non-unique SKUs" feature.
COST_PRICE_CANT_BE_NEGATIVE
400
Product cost price can't be negative.
WHOLESALE_PRICES_CANT_BE_NULL
400
Wholesale product price can't be zero.
WHOLESALE_PRICES_CANT_BE_NEGATIVE
400
Wholesale product price can't be negative.
WHOLESALE_PRICES_TOO_BIG
400
Wholesale product prices can't be higher than the default price.
WHOLESALE_PRICES_QUANTITY_TOO_SMALL
400
Wholesale product price must require at least two products.
OPTIONS_IS_NOT_FILES_TYPE
400
Options type must be "FILE".
DIFFERENT_COMBINATION_STOCK
400
Product variation with the same SKU as the main product must have the same stock.
DIFFERENT_COMBINATION_DIMENSIONS
400
Product variation with the same SKU as the main product must have the same dimensions.
COMBINATION_CONTAINS_REMOVED_OPTION
409
Product variation has removed product options.
COMBINATION_CONTAINS_REMOVED_OPTION_VALUE
409
Product variation has removed product option values.
COMBINATION_DUPLICATED
409
Product combination with this internal ID already exists.
NOT_ALLOWED_TO_UPDATE_EXTERNAL_CATEGORIES
409
Changing assigned products of external categories is not allowed.
NOT_ALLOWED_TO_UPDATE_PARAMETER
409
Changing product location inventory is not allowed in the store.
NOT_VIDEO_URL
422
Specified URL is not a video file.
VIDEO_NOT_SUPPORTED
422
Video format is not supported.
VIDEO_UNAVAILABLE
422
Product video is unavailable.
Domains
DOMAIN_ALREADY_TAKEN
400
Domain already taken by another store.
ILLEGAL_DOMAIN_NAME
400
Illegal domain name.
EMPTY_DOMAIN_NAME
403
Domain name must not be empty.
LONG_DOMAIN_NAME
403
Domain name is too long.
DOMAIN_FEATURE_NOT_AVAILABLE
403
Domain feature not available for the store.
NOT_ALLOWED_ON_CURRENT_PLAN
403
Domain feature not available on current plan.
WRONG_DOMAIN_FORMAT
403
Invalid domain format.
PAYMENT_METHOD_PROBLEM
403
Domain can't be bpught due to payment problems.
OPEN_SRS_WRONG_RESPONSE
403
Invalid response from domain provider.
REGISTRANT_CONTACT_DATA_VERIFICATION_ERROR
403
Verification error.
NOT_VALID_DOMAIN_ORDER_UPDATE_DATA
409
Invalid data in the domain update request.
Product reviews
PRODUCT_REVIEWS_FEATURE_NOT_AVAILABLE
403
Product reviews feature is disabled in the store.
PRODUCT_REVIEW_NOT_FOUND
404
Product reviews with specified ID was not found.
Promotions/discount coupons
MAX_PROMOTIONS_LIMIT_EXCEEDED
402
Maximum promotions limit in one request was exceeded (more than 100).
ADVANCED_DISCOUNTS_FEATURE_NOT_AVAILABLE
403
Promotions feature is disabled in the store.
DISCOUNTS_FEATURE_NOT_AVAILABLE
403
Discount coupons feature is disabled in the store.
SHIPPING_DISCOUNTS_FEATURE_NOT_AVAILABLE
403
Shipping discounts feature is disabled in the store.
CUSTOMER_GROUPS_FEATURE_NOT_AVAILABLE
403
Discounts for customer groups are disabled in the store.
PROMOTION_NOT_FOUND
404
Promotion with specified ID was not found.
DISCOUNT_COUPON_NOT_FOUND
404
Discount coupon with specified ID was not found.
READ_ONLY_PROMOTION_FIELD_CHANGE
422
Read-only fields cannot be changed.
Page slugs
SLUG_PARAMETER_NOT_FOUND
400
Specified page slug was not found.
SLUG_PARAMETER_EMPTY
400
Specified page slug is empty.
Ecwid billing for public apps
CHARGE_CURRENCY_INVALID
400
Invalid charge currency.
CHARGE_DESCRIPTION_INVALID
400
Invalid charge description.
CHARGE_IDEMPOTENCY_KEY_INVALID
400
Invalid idempotency key.
CHARGE_IDEMPOTENCY_KEY_NOT_UNIQUE
400
Non-unique idempotency key.
CHARGE_PURPOSE_INVALID
400
Invalid charge purpose.
CHARGE_PAYMENT_SOURCE_MISSING
402
Payment source missing.
CHARGE_LIMIT_EXCEEDED
402
Charge limit exceeded.
CHARGE_DECLINED
402
Charge declined.
Shipping/payment
SHIPPING_OPTION_TITLE_REQUIRED
400
Shipping option can't be created with empty title.
SHIPPING_CARRIER_NAME_REQUIRED
400
Shipping option can't be created with empty carrier name.
SHIPPING_TYPE_CARRIER_REQUIRED
400
Shipping option can't be created without a type.
SHIPPING_OPTION_ADDRESS_MISMATCH
409
Shipping option can't be created with this origin address.
SHIPPING_BAD_TITLE_LENGTH
400
Shipping title exceeds limit (100 characters).
SHIPPING_NOT_FOUND
404
Shipping option was not found in the store.
PAYMENT_OPTION_TITLE_REQUIRED
400
Payment option can't be created with empty title.
PAYMENT_GATEWAY_NAME_REQUIRED
400
Payment option can't be created with empty gateway name.
PAYMENT_GATEWAY_NAME_UNKNOWN
400
Payment option can't be created with the specified gateway name.
PAYMENT_GATEWAY_MISSING_SETTINGS
400
Payment option can't be created with mising settings.
PAYMENT_OPTION_BAD_TITLE_LENGTH
400
Payment option title exceeds limit (64 characters).
PAYMENT_GATEWAY_SETTING_VALUE_LENGTH_OUT_OF_BOUNDARIES
400
Payment gateway name exceeds limit (200 characters).
PAYMENT_GATEWAY_MALFORMED_SETTINGS_SIGNATURE_KEY_TOO_LONG
400
Payment gateway signature exceeds limit (128 characters).
PAYMENT_GATEWAY_IS_ALREADY_ADDED
409
This payment gateway is alread added to the store.
Last updated
Was this helpful?