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. |
| 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. |