Below is a table of common errors that you may encounter in response to interacting with the API resources.

Code Message Description
1000 Validation Error: %s There was an error while attempting to validate your request. The response will help you resolve the issue.
1003 Client is deactivated The client is currently pending deletion or deactivated by support, and can't use the API.
1005 Invalid access token The access token provided with the request is not recognized. It's possible the user revoked your permissions.
1007 Client with that ID doesn't exist The client ID supplied in the request headers can't be found in the system.
1008 Access Forbidden The client doesn't have authorization from the user. This usually means the user revoked access.
1009 Forbidden The client doesn't have permission to access this content.
1010 Service Unavailable The service is temporarily unavailable. Please wait before trying again.
1011 Consignor Address Error: %s There is an error with the consignor address based on requirements from the destination country. The response will help you resolve the issue.
1012 Shipping Address Error: %s There is an error with the shipping address based on requirements from the destination country and service. The response will help you resolve the issue.
1013 Return Address Error: %s There is an error with the return address based on requirements from the destination country. The response will help you resolve the issue.
1014 Consignee Address Error: %s There is an error with the consignee address based on requirements from the destination country. The response will help you resolve the issue.
1015 Too many API requests. Please wait before trying again. The user account is attempting to make too many requests at once.
1020 Media type not supported The request data could not be decoded, and/or the media type requested is not supported.
1025 Invalid page token The page_token is not valid or can't be decoded.
1030 Query parameter '%s' is required The parameter is required when performing that type of request. Read the documentation regarding that request for details.
1031 Query parameter '%s' is invalid The requested query parameter is invalid or formatted incorrectly.
1040 Entry point not found An entry point with that ID cannot be found.
1049 Shipping address unavailable under this service The requested recipient address is cannot be shipped to using the given service.
1050 No routes match your request There are no routes available based on the request. This may be due to a non-existant shipping method, the shipment exceeding the maximum weight or dimensions, unqualified dangerous goods, or no service is available to the shipping address.
1080 Insufficient funds The user's account balance is out of funds. The user needs to add money to their balance.
1090 Invoice not found An invoice with that ID could not be found.
1100 Subscription could not be created A new subscription could not be created possibly due to an internal server error.
1101 Subscription not found A subscription with that ID was not found.
1102 Subscription is active An active subscription cannot be renewed.
1103 Subscription is cancelled A subscription must be active to be cancelled.
1104 Duplicate subscription Applications can only have one subscription at a time per user.
1120 Return not found A return with that ID was not found.
1121 Return cannot be verified The return status must be "Processed" in order to verify it.
1122 Return cannot be discarded The return status must be "Processed", "Verifying", or "Verified" in order to discard it.
1140 Reshipment not found A reshipment with that ID was not found.
1141 Reshipment cannot be updated The reshipment must have a status of "Pending" to be updated.
1142 Reshipment cannot be deleted Reshipments with the status "Approved" cannot be deleted.
1143 One or more returns cannot be reshipped Only returns that belong to the user and are not attached to a reshipment can be included.
1144 Return cannot be reshipped: %s The return can't be reshipped because of the provided reason.
1200 Shipping address is not verified The shipping address cannot be verified. The address must be corrected by the user.
1201 Shipment has uncancelled or processed labels The shipment already has an uncancelled or processed label. Labels can be cancelled but shipments with processed labels cannot generate new labels.
1203 Label could not be created: %s There was an error attempting to create a label. A reason will sometimes be provided.
1204 Label was cancelled Cancelled labels cannot be modified.
1205 Label not found A label with that tracking number could not be found.
1206 Label cannot be cancelled The label was processed or cancelled already, or exceeded the time limit.
1210 Shipment not found A shipment with that ID could not be found.
1212 Shipment could not be deleted Only test shipments or shipments without labels can be deleted.
1215 Shipment requires an HS Code and description for all line items Shipment line items must include an hts_code for the import country.
1216 Shipment entry point does not match the overpack The shipment's entry_point must match the overpack's entry_point when setting the overpack_id.
1217 Shipment and overpack must use the same service The shipment can't be added to the overpack if they do not use the same shipping service.
1218 Shipment is part of an overpack Shipments that are linked to an overpack cannot be deleted.
1219 Duplicate shipment in overpack A shipment with an identical tracking number is already included in the overpack.
1220 Shipments to '%s' don't require a manifest Some entry points don't require overpacks or manifests. Users can drop off labelled shipments.
1221 DG and non-DG shipments can't be inside the same overpack DG and non-DG shipments can't be inside the same overpack
1222 Origin description for [%s] must be in the entry point's language Line item origin descriptions must be in the entry point's language.
1223 Description for [%s] is not allowed. Line item description is not valid or contains forbidden words.
1230 Exception not found An exception with that ID could not be found.
1240 Recipient is a denied party and can't be shipped to Recipient is considered a denied party and can't be shipped to.
1242 Shipment contains prohibited/restricted goods. Shipment contains prohibited or restricted goods and can not be shipped.
1243 Unable to get tax and/or duty rates for this shipment. Unable to get tax and/or duty rates for this shipment from our third party provider.
1250 Overpack not found: %s One or more overpacks with the specified ID could not be found.
1251 Overpack is locked The overpack cannot be updated because it was included with a transmitted manifest and is locked.
1252 Overpack could not be created There was an error creating the overpack.
1270 Overpack %s is empty or contains test shipments The manifest can't contain empty cartons or test shipments.
1271 All overpacks must have the same entry point The manifest cannot be created because one or more of the overpacks do not share the same entry_point.
1272 Overpack %s was used in another manifest The manifest can't be created because one or more of the overpacks are already locked.
1273 Overpack %s is missing weight or dimensions The manifest cannot be created because one of the overpacks is missing the weight or dimensions.
1274 Manifest could not be created The manifest cannot be created due to an internal server error.
1275 Manifest not found A manifest with the ID provided doesn't exist.
1300 Resource not found The requested resource is not implemented or the request method is not allowed. Check the corresponding documentation.
1320 Order not found An order with that ID could not be found.
1321 Order cannot be modified The order's status indicates that it can no longer be updated or deleted.
1322 Order could not be deleted There was an internal server error trying to delete your order.
1323 Order could not be created There was an internal server error trying to create your order.
1324 Order could not be updated There was an internal server error trying to update your order.
1325 Line items must be unique Two or more line items contains matching SKUs.
1326 Duplicate Order '%s' There's already an order in the Shop with that Shop Order ID.
1330 SKU '%s' does not exist in Shop '%s' There is no product in that Shop with that SKU.
1331 SKU '%s' is inactive The SKU needs to be activated by the user before creating an order with it.
1332 Product not found A product with that ID was not found.
1333 Product cannot be deleted The product is associated with one or more orders and can't be deleted.
1334 SKU '%s' for Shop '%s' is already in use That SKU already exists for the specified shop.
1335 SKU cannot be deleted The SKU is associated with one or more orders and can't be deleted.
1336 Product cannot be deleted There was an internal server error trying to delete your product.
1337 Only one SKU can be active for Product '%s' in Shop '%s' Deactivate the other SKU before adding or activating another one.
1338 Contact support to update barcode for Product %s Product barcode cannot be updated by user while inventory exists at a warehouse
1339 Product '%s' missing warehouse description in the local language The product is missing a description in the warehouse's local language.
1340 Packing slip is required for a gift message Gift messages can't be included with orders without packing slips.
1341 Packaging is not allowed in orders Orders can't contain products that are packaging material.
1350 Inbound shipment not found An inbound shipment with that ID could not be found.
1351 Inbound shipment cannot be deleted The inbound shipment's status must be "Accepted" in order to delete it.
1352 Product not found: %s One of the requested products were not found or do not belong to you.
1353 Inbound shipment cannot be updated The inbound shipment is locked and can't be updated.
1354 Duplicate products in the shipment: %s There are duplicate product IDs in the inbound shipment.
1360 Warehouse not found The requested warehouse ID does not exist.
1370 Shop not found A shop with that ID could not be found.
1371 Shop cannot be deleted The shop can't be deleted because there are linked orders or SKUs.
1373 Shop ID must be unique The shop cannot be created because the shop ID is already in use.
1374 Shop '%s' is inactive The Shop needs to be activated before orders can be created.
1400 Webhook not found Webhook not found for this user and application.
1401 User already subscribed to topic Applications can't subscribe users to the same topic.
1402 Webhook could not be created Unable to create a webhook due to an error.
1403 Webhook address is not valid The requested address does not conform to the guidelines.
1450 Credential not found A credential with that ID could not be found.
1451 Credential cannot be modified The credential's status indicates that it can no longer be updated or deleted.
1452 Credential could not be deleted There was an internal server error trying to delete your credential.
1453 Credential could not be created There was an internal server error trying to create your credential.
1454 Credential could not be updated There was an internal server error trying to update your credential.