Common Errors
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. |
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. |
1030 | %s parameter is required | The parameter '%s' is required when performing that type of request. Read the documentation regarding that request for details. |
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. |
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. |