{"info":{"_postman_id":"88f8bc35-761d-4f3d-8ef7-52cae6de90d3","name":"International Mail Duty Collection API","description":"<html><head></head><body><h1 id=\"international-mail-duty-collection-api-documentation\">International Mail Duty Collection API Documentation</h1>\n<h2 id=\"entry-type-13-pga-data-required-from-january-20-2027\">Entry Type 13 PGA Data: required from January 20, 2027</h2>\n<p>CBP's <strong>Entry Type 13</strong> filing needs <strong>PGA (Partner Government Agency)</strong> data for package items whose HTS code is regulated by a government agency. The package submission endpoints (<code>/packages</code> and <code>/shipments</code>) accept it in the item-level field:</p>\n<ul>\n<li><strong>pgaDataset</strong>: the item's PGA data<ul>\n<li><strong>statements</strong>: product-use statements (e.g. <code>NotForMedicalUse</code>, <code>NotForFoodContact</code>) that confirm a shipping condition or rule an agency out</li>\n<li><strong>fda</strong>: FDA filing (Food Contact or Cosmetics program)</li>\n<li><strong>cpsc</strong>: CPSC certificate (registry reference or full certificate)</li>\n<li><strong>laceyAct</strong>: APHIS Lacey Act declaration (plant products)</li>\n<li><strong>aphisCore</strong>: APHIS Core declaration (plant and animal health)</li>\n<li><strong>tsca</strong>: EPA Toxic Substances Control Act certification</li>\n<li><strong>fishAndWildlife</strong>: U.S. Fish and Wildlife Service declaration</li>\n</ul>\n</li>\n</ul>\n<p>The field is <strong>optional today</strong> and <strong>becomes required on January 20, 2027, depending on the HTS code of the item</strong>:</p>\n<ul>\n<li>an agency the HTS code marks as <strong>required</strong> needs its filing</li>\n<li>an agency the HTS code marks as <strong>conditional</strong> needs either its filing or one of the statement sets that rule the agency out</li>\n<li>indicators of agencies without a filing section (for example USDA organic or DEA) are cleared with the matching statements</li>\n<li>HTS codes that are only <strong>conditionally approved</strong> for shipping need the listed product-use statements; codes that are <strong>not approved</strong> (including codes with an open antidumping or countervailing duty case) are rejected</li>\n</ul>\n<p>From that date, packages whose items miss the data their HTS code needs are rejected. Use the <strong>Get HTS Code Requirements</strong> endpoint (<code>GET /api/v1/hts/{htsCode}/requirements</code>) to see exactly what a code needs, see the field documentation on <strong>Create Packages</strong> for the field shape, and start sending the data now to avoid disruption when the requirement takes effect.</p>\n<h2 id=\"overview\">Overview</h2>\n<p>The International Mail Duty Collection API allows developers to integrate comprehensive customs and duty processing capabilities within their shipping and e-commerce applications. The API offers package creation, container management, shipment processing, and automated duty calculation features.</p>\n<p><strong>Getting Started:</strong> For additional help, please email us at <a href=\"mailto:support@safepackage.com\"><b>support@safepackage.com</b></a>.</p>\n<p><strong>Account Setup:</strong> To request API access, please email <a href=\"mailto:api-access@safepackage.com\"><b>api-access@safepackage.com</b></a> with your business information and integration requirements. Our team will provision your account and provide the necessary credentials for authentication.</p>\n<h2 id=\"endpoints-and-services\">Endpoints and Services</h2>\n<p><strong>Package Management</strong><br>Create and manage individual mail packages with detailed customs information including country of origin, declared values, and item details.</p>\n<p><strong>Container Operations</strong><br>Group packages into containers with comprehensive entry route information including flight numbers, vessel details, transport types, carrier codes, and port of entry data.</p>\n<p><strong>Shipment Processing</strong><br>Process complete shipments with multiple containers and packages in a single operation. This powerful endpoint combines package creation, container management, and automatic associations in one streamlined workflow.</p>\n<p><strong>Package Lookup and Labels</strong><br>Look up one of your packages by package id or tracking number, and generate the shipping label of a package (Japan Post accounts), receiving the label PDF directly.</p>\n<p><strong>HTS Code Requirements and Duty Estimates</strong><br>Check what an HTS code needs before submitting (quantity units, components, shipping approval and PGA data), and calculate duties for items without creating packages.</p>\n<h2 id=\"authentication-and-security\">Authentication and Security</h2>\n<p>The International Mail Duty Collection API uses JWT Bearer token authentication via OAuth2 integration. All API requests require proper authentication using JWT Bearer tokens.</p>\n<p><strong>Authentication Setup</strong><br>Obtain your JWT tokens with the OAuth2 client credentials flow from the token endpoint of your environment (see <strong>API Information</strong> below), e.g. <a href=\"https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token\">https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token</a> in production. Configure your application with the client credentials provided during account setup and send the token as <code>Authorization: Bearer &lt;token&gt;</code> on every request.</p>\n<h2 id=\"duty-calculation-and-compliance\">Duty Calculation and Compliance</h2>\n<p><strong>Automatic Duty Calculation</strong><br>The API automatically calculates duties and tariffs based on country of origin, declared values, current trade policy and tariff rates.</p>\n<h2 id=\"api-information\">API Information</h2>\n<p><strong>Production Environment</strong></p>\n<ul>\n<li><p><strong>Base URL</strong>: <a href=\"https://dutycollection.safepackage.com\">https://dutycollection.safepackage.com</a></p>\n</li>\n<li><p><strong>Authentication URL (token endpoint)</strong>: <a href=\"https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token\">https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token</a></p>\n</li>\n</ul>\n<p><strong>Sandbox Environment</strong></p>\n<ul>\n<li><p><strong>Base URL</strong>: <a href=\"https://dutycollection-sandbox.safepackage.com\">https://dutycollection-sandbox.safepackage.com</a></p>\n</li>\n<li><p><strong>Authentication URL (token endpoint)</strong>: <a href=\"https://auth.dutycollection-sandbox.safepackage.com/realms/SafePackage/protocol/openid-connect/token\">https://auth.dutycollection-sandbox.safepackage.com/realms/SafePackage/protocol/openid-connect/token</a></p>\n</li>\n</ul>\n<h2 id=\"support-and-resources\">Support and Resources</h2>\n<p><strong>Getting Help</strong></p>\n<ul>\n<li><p><strong>Email Support</strong>: <a href=\"mailto:support@safepackage.com\">support@safepackage.com</a></p>\n</li>\n<li><p><strong>Account Setup</strong>: Email <a href=\"mailto:api-access@safepackage.com\">api-access@safepackage.com</a> for account provisioning</p>\n</li>\n<li><p><strong>Integration Assistance</strong>: Custom implementation support available</p>\n</li>\n</ul>\n<h2 id=\"duty-exempt-hts-codes\">Duty-exempt HTS codes</h2>\n<p>The API allows the submittal of item HTS code information, which helps to differentiate between taxable and exempt goods. Listed below is a table of eligible HTS code prefixes. If an HTS code begins with one of the listed prefixes, it is eligible for a duty exemption.</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>HTS Code Prefix</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>3704.00.00</td>\n</tr>\n<tr>\n<td>3705.00.00</td>\n</tr>\n<tr>\n<td>3706</td>\n</tr>\n<tr>\n<td>Chapter 49 (HTS codes starting with 49)</td>\n</tr>\n<tr>\n<td>5807</td>\n</tr>\n<tr>\n<td>6307.90.30</td>\n</tr>\n<tr>\n<td>6307.90.85</td>\n</tr>\n<tr>\n<td>8310</td>\n</tr>\n<tr>\n<td>8523.29</td>\n</tr>\n<tr>\n<td>8523.41</td>\n</tr>\n<tr>\n<td>8523.49</td>\n</tr>\n<tr>\n<td>8523.80.10</td>\n</tr>\n<tr>\n<td>9405.61</td>\n</tr>\n<tr>\n<td>9405.69</td>\n</tr>\n<tr>\n<td>9701</td>\n</tr>\n<tr>\n<td>9702</td>\n</tr>\n<tr>\n<td>9703</td>\n</tr>\n<tr>\n<td>9704</td>\n</tr>\n<tr>\n<td>9705</td>\n</tr>\n<tr>\n<td>9903.01.03</td>\n</tr>\n<tr>\n<td>9903.01.12</td>\n</tr>\n<tr>\n<td>9903.01.22</td>\n</tr>\n<tr>\n<td>9903.01.31</td>\n</tr>\n</tbody>\n</table>\n</div><p>2 separate HTS codes can also be used to claim tax exemption, but are part of specific cases:</p>\n<ul>\n<li><p>9804.00.30 - HTS code for items specified as gifts, where all items in the package are eligible for duty exemption if the they all have the specified HTS code and the total declared value of the package does not exceed $100</p>\n</li>\n<li><p>9801.00.10 - Returns, items whose country of origin is the US which are being returned to the country</p>\n</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"International Mail Duty Collection API Documentation","slug":"international-mail-duty-collection-api-documentation"}],"owner":"48610445","collectionId":"88f8bc35-761d-4f3d-8ef7-52cae6de90d3","publishedId":"2sBYHaMw8M","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"BA2D53"},"publishDate":"2026-11-11T12:32:53.000Z"},"item":[{"name":"Authentication","item":[{"name":"Client Credentials Authentication","id":"1d878937-4266-41b0-9d4c-362cfd284df8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"}],"body":{"mode":"urlencoded","urlencoded":[{"type":"text","key":"grant_type","value":"client_credentials"},{"type":"text","key":"client_id","value":""},{"type":"text","key":"client_secret","value":""}]},"url":"https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token","urlObject":{"host":["https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token"],"query":[],"variable":[]}},"response":[],"_postman_id":"1d878937-4266-41b0-9d4c-362cfd284df8"}],"id":"8e71c965-fee9-44bc-98c1-bceb43a79ea9","description":"<p>Authentication samples for obtaining an access token from the authentication URL</p>\n","_postman_id":"8e71c965-fee9-44bc-98c1-bceb43a79ea9"},{"name":"Packages","item":[{"name":"Create Packages","id":"4f83ed5a-fc23-4eeb-8ff5-4efdd35e2f2a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer ","description":"<p>JWT token for authentication</p>\n"}],"body":{"mode":"raw","raw":"{\n    \"inputCurrency\": \"USD\",\n    \"packages\": [\n        {\n            \"trackingReference\": \"US123456789US\",\n            \"classificationType\": \"Regular\",\n            \"sender\": {\n                \"fullName\": \"John Doe\",\n                \"email\": \"john.doe@example.com\",\n                \"address\": {\n                    \"addressLine\": \"1 Example Street\",\n                    \"city\": \"Example City\",\n                    \"zipCode\": \"00000\",\n                    \"countryIso2Code\": \"JP\"\n                }\n            },\n            \"consignee\": {\n                \"fullName\": \"Jane Doe\",\n                \"address\": {\n                    \"addressLine\": \"2 Example Avenue\",\n                    \"city\": \"Springfield\",\n                    \"state\": \"IL\",\n                    \"zipCode\": \"00000\",\n                    \"countryIso2Code\": \"US\"\n                }\n            },\n            \"items\": [\n                {\n                    \"externalReference\": \"SKU-0001\",\n                    \"images\": [\n                        {\n                            \"reference\": \"IMG-0001\",\n                            \"base64Content\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=\"\n                        }\n                    ],\n                    \"countryOfOrigin\": \"CN\",\n                    \"totalDeclaredValue\": 77.97,\n                    \"description\": \"Men's knitted cotton t-shirt, short sleeve\",\n                    \"htsCode\": \"6109.10.00.12\",\n                    \"quantity\": 3,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 0.6,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ]\n                },\n                {\n                    \"externalReference\": \"SKU-0002\",\n                    \"manufacturer\": {\n                        \"businessName\": \"Example Ceramics Co.\",\n                        \"address\": {\n                            \"addressLine\": \"3 Example Road\",\n                            \"city\": \"Example City\",\n                            \"countryIso2Code\": \"JP\"\n                        }\n                    },\n                    \"singleUnitDeclaredValue\": 45.5,\n                    \"description\": \"Ceramic coffee mug, hand painted\",\n                    \"htsCode\": \"6912.00.44.00\",\n                    \"quantity\": 2,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 1.4,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ],\n                    \"pgaDataset\": {\n                        \"statements\": [\n                            \"NotForMedicalUse\"\n                        ],\n                        \"fda\": {\n                            \"program\": \"FoodContact\",\n                            \"intendedUseCode\": \"FoodAdditiveOrFoodContactSubstance\",\n                            \"productCode\": \"23FGH07\",\n                            \"countryOfProductionIso2Code\": \"JP\",\n                            \"tradeBrandName\": \"Example Brand\",\n                            \"productSpecificDescription\": \"Hand painted ceramic coffee mug, 350 ml\",\n                            \"packagingLevels\": [\n                                {\n                                    \"quantity\": 1,\n                                    \"unitCode\": \"BX\"\n                                },\n                                {\n                                    \"quantity\": 2,\n                                    \"unitCode\": \"PCS\"\n                                }\n                            ]\n                        }\n                    }\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"CN987654321CN\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"DE\",\n                    \"totalDeclaredValue\": 75.0,\n                    \"description\": \"Leather wallet, bovine\",\n                    \"htsCode\": \"4202.31.60.00\",\n                    \"quantity\": 1,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 0.2,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/packages","description":"<h1 id=\"create-packages\">Create Packages</h1>\n<p>Creates multiple packages in a single operation and calculates their duties. Each package can contain multiple items with different countries of origin and declared values. Submitting a package again with the tracking reference of one of your existing packages updates that package instead of creating a new one.</p>\n<h2 id=\"request-body-fields\">Request Body Fields</h2>\n<h3 id=\"root-object\">Root Object</h3>\n<ul>\n<li><strong>packages</strong> (array, required): Collection of packages to create<ul>\n<li>At most 1000 items in total across all packages of a request (<code>V_MaxItemCountExceeded</code>)</li>\n</ul>\n</li>\n<li><strong>inputCurrency</strong> (string, optional): ISO 4217 code of the currency the declared values are in. Defaults to <code>USD</code><ul>\n<li>An unknown code fails the request with <code>V_InvalidCurrencyCode</code>; amounts with more decimals than the currency allows fail with <code>V_InvalidAmountPrecision</code></li>\n<li>Totals in the response are always in USD</li>\n</ul>\n</li>\n<li><strong>dataProviderCode</strong> (string, optional): Code of the data provider the packages are submitted through, when one has been agreed with your account. Omit it otherwise</li>\n</ul>\n<h3 id=\"package-object\">Package Object</h3>\n<ul>\n<li><strong>trackingReference</strong> (string, optional): Tracking number of the package<ul>\n<li>Format: UPU S10 (2 letters + 9 digits + 2 letters) or USPS IMPB (22/26/30/34 digits), max 50 characters (<code>V_InvalidTrackingReferenceFormat</code>, <code>V_MaxLengthExceeded</code>)</li>\n<li>Example: <code>US123456789US</code>, <code>CN987654321CN</code></li>\n<li>Must be unique across all packages: a reference already used by another account rejects the package with <code>D_PackageReferenceAlreadyInUse</code></li>\n<li>Packages without one count as duplicates of each other, so at most one package per request may omit it</li>\n<li>A package needs a tracking reference before it can be added to a container</li>\n</ul>\n</li>\n<li><strong>classificationType</strong> (string, optional): <code>Regular</code> (default), <code>Gift</code> or <code>Return</code></li>\n<li><strong>sender</strong> (object, optional): Sender contact: <strong>fullName</strong> (max 255), <strong>businessName</strong> (max 255), <strong>email</strong> (required when <code>sender</code> is sent, valid e-mail address), <strong>phoneNumber</strong>, <strong>address</strong>, <strong>locale</strong> (IETF language tag such as <code>ja-JP</code>)</li>\n<li><strong>consignee</strong> (object, optional): Consignee contact with the same fields (email not required)</li>\n<li>A contact <strong>address</strong> carries <strong>addressLine</strong>, <strong>city</strong>, <strong>state</strong>, <strong>zipCode</strong> and <strong>countryIso2Code</strong> (required, ISO 3166-1 alpha-2)</li>\n</ul>\n<h3 id=\"package-items-array\">Package Items Array</h3>\n<ul>\n<li><strong>items</strong> (array, required): Collection of items within the package<ul>\n<li>Minimum: 1 item required per package</li>\n</ul>\n</li>\n</ul>\n<h3 id=\"package-item-object\">Package Item Object</h3>\n<ul>\n<li><strong>description</strong> (string, required): Description of the item, max 100 characters<ul>\n<li>Example: <code>Men's knitted cotton t-shirt, short sleeve</code></li>\n<li>Drives HTS classification whenever the submitted <code>htsCode</code> is not a full 10-digit code</li>\n</ul>\n</li>\n<li><strong>countryOfOrigin</strong> (string, conditional): ISO 3166-1 alpha-2 code of the country of origin<ul>\n<li>Examples: <code>CN</code> (China), <code>JP</code> (Japan), <code>DE</code> (Germany), <code>US</code> (United States)</li>\n<li>Required unless <strong>manufacturer.address.countryIso2Code</strong> is supplied, which then is the item's country of origin (<code>V_ValueEmpty</code> when neither is sent)</li>\n<li>When both are supplied they must be the same country (<code>V_CountryOfOriginMismatch</code>)</li>\n<li>An unknown code fails the request with <code>V_InvalidCountryCode</code></li>\n</ul>\n</li>\n<li><strong>manufacturer</strong> (object, optional): Manufacturer contact (<code>fullName</code>, <code>businessName</code>, <code>email</code>, <code>phoneNumber</code>, <code>address</code>, <code>locale</code>)<ul>\n<li><code>address.countryIso2Code</code> is the item's country of origin when given; the other fields are stored with the item</li>\n<li>A manufacturer without an address takes its country from <code>countryOfOrigin</code></li>\n</ul>\n</li>\n<li><strong>Declared value: exactly one of the following fields must be set per item</strong> (<code>V_ExactlyOneValueRequired</code>):<ul>\n<li><strong>totalDeclaredValue</strong> (number, recommended): Declared value of the whole line (all units together)</li>\n<li><strong>singleUnitDeclaredValue</strong> (number): Declared value of one unit; the line total is this value times <code>quantity</code></li>\n<li><strong>declaredValue</strong> (number, deprecated): Legacy field kept for existing integrations; carries the <strong>line total</strong>, not a per-unit value</li>\n<li>The value must be greater than zero (<code>V_ValueMustBeGreaterThanZero</code>), except on return items (<code>9801.00.10</code>)</li>\n<li>In <code>inputCurrency</code>, with at most the decimals that currency allows (2 for USD, 0 for JPY)</li>\n<li>The sum of all item line totals in a package, converted to USD, must not exceed $2,500 (postal clearance limit); a package above it is rejected with <code>V_PackageDeclaredValueExceedsAllowedLimit</code></li>\n</ul>\n</li>\n<li><strong>htsCode</strong> (string, optional): Harmonized Tariff Schedule (HTS) code, dotted or plain digits<ul>\n<li>Accepted at 6, 8 or 10 digits (<code>V_InvalidHtsCode</code> otherwise), but duties are always calculated against a <strong>full 10-digit</strong> schedule code</li>\n<li>A 6/8-digit code is treated as a classification hint; the remaining digits are resolved from the item <code>description</code></li>\n<li>Submit the full 10-digit code (e.g. <code>6109.10.00.12</code>) for deterministic classification and pricing</li>\n</ul>\n</li>\n<li><strong>quantity</strong> (number, optional): Number of units in the line. Whole number, minimum 1, defaults to 1 (<code>V_ValueMustBeWholeNumber</code>)</li>\n<li><strong>customsQuantities</strong> (array, optional): Line-total quantities in the units a tariff rate can bill on<ul>\n<li>Each entry: <strong>value</strong> (number, &gt; 0) and <strong>unitOfMeasure</strong> (string): one of <code>Kg</code>, <code>Gram</code>, <code>Number</code>, <code>Dozen</code>, <code>SquareMeter</code>, <code>CubicMeter</code>, <code>MetricTon</code>, <code>Liter</code>, <code>ProofLiter</code>, <code>Barrel</code>, <code>Gross</code>, <code>Pair</code>, <code>Per1000</code></li>\n<li>At most one entry per unit of measure (<code>V_DuplicateValuesNotAllowed</code>)</li>\n<li>Include a mass entry (e.g. <code>{ \"value\": 0.6, \"unitOfMeasure\": \"Kg\" }</code> for the whole line) whenever the tariff bills on weight; call <strong>Get HTS Code Requirements</strong> with the item's HTS code and country of origin to see which units are needed</li>\n</ul>\n</li>\n<li><strong>singleUnitWeight</strong> (object, deprecated): Weight of the <strong>whole line</strong> (despite the name), folded into <code>customsQuantities</code> as a mass entry<ul>\n<li><strong>value</strong> (number, &gt; 0) and <strong>unitOfMeasure</strong> (string): one of <code>Pounds</code>, <code>Kilograms</code>, <code>Grams</code></li>\n</ul>\n</li>\n<li><strong>weight</strong> (object, deprecated): Same meaning as <code>singleUnitWeight</code>; only one of the two may be set (<code>V_MutuallyExclusiveProperties</code>)</li>\n<li><strong>externalReference</strong> (string, optional): Your own reference for the item, returned in the response</li>\n<li><strong>components</strong> (array, optional, max 20): Component classifications declared separately for CBP (e.g. watch movements, see <code>requiredComponents</code> in <strong>Get HTS Code Requirements</strong>)<ul>\n<li>Each entry: <strong>name</strong> (string, required), <strong>htsCode</strong> (string, required, 10 digits), <strong>description</strong> (string), <strong>declaredValue</strong> (number, &gt;= 0), <strong>quantity</strong> (number, &gt; 0, default 1), <strong>unitOfMeasure</strong> (unit as above, default <code>Number</code>)</li>\n<li>Component HTS codes must be unique within an item</li>\n</ul>\n</li>\n<li><strong>provenance</strong> (object, optional): Metal origin data for Section 232 steel and aluminum duties: <strong>countryOfMeltAndPour</strong>, <strong>primaryCountryOfSmelt</strong>, <strong>secondaryCountryOfSmelt</strong>, <strong>countryOfCast</strong> (ISO 3166-1 alpha-2 codes)</li>\n</ul>\n<p><strong>Duties are calculated against the full HTS schedule:</strong> every item must resolve to a valid 10-digit HTS code, from the submitted <code>htsCode</code> or from the <code>description</code> via classification, or the package is rejected with <code>APP_HtsClassificationFailed</code>. A mass entry in <code>customsQuantities</code> is required whenever the resolved tariff bills on weight.</p>\n<h3 id=\"item-images\">Item Images</h3>\n<ul>\n<li><strong>images</strong> (array, optional, max 3 per item): photos of the item, stored with the package. More than three images on an item fails the whole request with <code>400 Bad Request</code> (<code>V_MaxImageCountExceeded</code>)<ul>\n<li><strong>base64Content</strong> (string, required): the image bytes as plain base64, without a <code>data:image/...;base64,</code> prefix. Empty or invalid content (including a data URL) fails the whole request with <code>400 Bad Request</code> (<code>V_InvalidImageContent</code>)</li>\n<li><strong>reference</strong> (string, optional): your own identifier for the image, stored with it</li>\n</ul>\n</li>\n</ul>\n<h3 id=\"pga--entry-type-13-data\">PGA / Entry Type 13 Data</h3>\n<ul>\n<li><strong>pgaDataset</strong> (object, optional until January 20, 2027, then required depending on the item's HTS code): PGA (Partner Government Agency) data for the item, driven by its HTS code. Call <strong>Get HTS Code Requirements</strong> for the code to see what is needed. When sent, it must carry at least one of <code>statements</code>, <code>fda</code>, <code>cpsc</code>, <code>laceyAct</code>, <code>aphisCore</code>, <code>tsca</code> or <code>fishAndWildlife</code> (otherwise the request fails with <code>400 Bad Request</code>, <code>V_PgaDatasetEmpty</code>)</li>\n</ul>\n<h4 id=\"pgadatasetstatements\">pgaDataset.statements</h4>\n<p>Facts the shipper confirms about the product, as an array of unique statement values (e.g. <code>[\"NotForMedicalUse\", \"NotForFoodContact\"]</code>). Statements serve two purposes:</p>\n<ul>\n<li><strong>Shipping approval</strong>: when the code is <code>ConditionallyApproved</code>, every value in the requirements' <code>shipmentApproval.disclaimersRequiredForShippingApproval</code> must be declared (<code>NotForMedicalUse</code>, <code>ForExternalUseOnly</code>, <code>NotFood</code>). A missing one rejects the item with <code>V_ProductUseDisclaimersRequired</code></li>\n<li><strong>Disclaiming a conditional agency</strong>: when an agency's requirement is <code>Conditional</code>, declaring every statement of one of its <code>disclaimers</code> sets replaces that agency's filing. The item is then filed as <em>not regulated by the agency</em></li>\n</ul>\n<p>Declare only what is true of the product. A statement nothing requires has no effect. Values: <code>NotForMedicalUse</code>, <code>ForExternalUseOnly</code>, <code>NotFood</code>, <code>NotForFoodContact</code>, <code>NotACosmetic</code>, <code>NotAChildrensProduct</code>, <code>NotAphisRegulated</code>, <code>ContainsNoPlantMaterial</code>, <code>PlantMaterialDeMinimis</code>, <code>ContainsNoFishOrWildlife</code>, <code>NotOrganic</code>, <code>NotAPesticide</code>, <code>ContainsNoHydrofluorocarbons</code>, <code>ContainsNoOzoneDepletingSubstances</code>, <code>NotAVehicleOrEngine</code>, <code>NotTtbRegulated</code>, <code>NotAControlledSubstance</code>, <code>NotARegulatedMachine</code>, <code>NotFsisRegulated</code>, <code>NotACoveredFishSpecies</code> (meanings are listed under <strong>Get HTS Code Requirements</strong>). An unknown value fails the whole request with <code>400 Bad Request</code></p>\n<h4 id=\"pgadatasetfda\">pgaDataset.fda</h4>\n<p>The FDA filing for the item. Required when the requirements' <code>fda.requirement</code> is <code>Required</code>; for <code>Conditional</code>, file it or declare one of the <code>fda.disclaimers</code> statement sets.</p>\n<ul>\n<li><p><strong>program</strong> (string, optional): <code>FoodContact</code> or <code>Cosmetics</code>. When the requirements return an <code>fda.program</code>, file under that program. When omitted, <code>FoodContact</code> is used if the <code>intendedUseCode</code> is one FDA accepts for Food Contact (<code>FoodAdditiveOrFoodContactSubstance</code>, <code>Export</code>, <code>OtherUse</code>), otherwise <code>Cosmetics</code></p>\n</li>\n<li><p><strong>intendedUseCode</strong> (enum, required): the FDA import scenario, restricted to the codes FDA accepts for the program (FDA Supplemental Guide 2.5.12). <code>Cosmetics</code>: <code>PersonalUse</code> (100.000), <code>PublicExhibition</code> (110.000), <code>ConsumerUse</code> (130.000), <code>CommercialProcessing</code> (150.000), <code>ResearchAndDevelopment</code> (180.000), <code>UsGoodsReturned</code> (920.000), <code>Export</code> (970.000), <code>OtherUse</code> (980.000). <code>FoodContact</code>: <code>FoodAdditiveOrFoodContactSubstance</code> (130.029), <code>Export</code>, <code>OtherUse</code>. A code outside the program's list is rejected with <code>V_IntendedUseCodeNotAllowedForProgram</code></p>\n</li>\n<li><p><strong>productCode</strong> (string, required, max 19): FDA product code</p>\n</li>\n<li><p><strong>countryOfProductionIso2Code</strong> (string, required): 2-letter ISO code of the country of production</p>\n</li>\n<li><p><strong>tradeBrandName</strong> (string, required, max 35)</p>\n</li>\n<li><p><strong>productSpecificDescription</strong> (string, required, max 57)</p>\n</li>\n<li><p><strong>packagingLevels</strong> (array, required, 1–6 entries): all levels of packaging from outermost to innermost. Each entry carries <strong>quantity</strong> (number, up to 2 decimals) and <strong>unitCode</strong> (string, max 5, an ACE packaging unit code such as <code>BX</code>, <code>CT</code>, <code>PKG</code>, <code>PCS</code>). The last entry must be a base unit (e.g. <code>PCS</code>)</p>\n</li>\n<li><p><strong>manufacturerFei</strong> (string, optional, max 15, alphanumeric): the manufacturer's FDA Establishment Identifier</p>\n</li>\n</ul>\n<h4 id=\"pgadatasetcpsc\">pgaDataset.cpsc</h4>\n<p>The CPSC certificate for the item. Required when the requirements' <code>cpsc.requirement</code> is <code>Required</code>; for <code>Conditional</code>, file it or declare <code>NotAChildrensProduct</code>. Submit <strong>either</strong> a registry reference <strong>or</strong> the complete certificate elements.</p>\n<ul>\n<li><p><strong>registryReference</strong> (object): <code>certifierId</code>, <code>productId</code>, <code>versionId</code> (strings, required) of a certificate filed in the CPSC registry</p>\n</li>\n<li><p>Complete certificate: <strong>productId</strong> (string, max 19), <strong>citationCodes</strong> (array of strings, max 30 each, unique), <strong>manufactureDate</strong> (<code>YYYY-MM-DD</code>), <strong>manufacturePlace</strong> (contact with address), <strong>productTestDate</strong> (<code>YYYY-MM-DD</code>), <strong>testingLaboratory</strong> (contact with address), <strong>pointOfContact</strong> (contact)</p>\n</li>\n<li><p>A contact carries <strong>name</strong> (string, required, max 32), <strong>address</strong> (object: <code>line1</code> required max 23, <code>line2</code> max 32, <code>city</code> required max 21, <code>stateOrProvince</code> max 3, <code>countryIso2Code</code> required, <code>postalCode</code> max 9), <strong>email</strong> (max 35) and <strong>phone</strong> (max 15)</p>\n</li>\n</ul>\n<h4 id=\"pgadatasetlaceyact-aphiscore-tsca-fishandwildlife\">pgaDataset.laceyAct, aphisCore, tsca, fishAndWildlife</h4>\n<p>Filings for the other agencies an HTS code can flag. Submit each one whose requirement is <code>Required</code>; for a <code>Conditional</code> one, file it or declare one of that agency's <code>disclaimers</code> statement sets.</p>\n<ul>\n<li><p><strong>laceyAct</strong> (<code>AL</code> indicators): <strong>countryOfHarvestIso2Code</strong> (string, required), <strong>scientificName</strong> (object: <code>genus</code> required max 22, <code>species</code> required max 22, <code>subspecies</code> max 18), <strong>commonName</strong> (string, required, max 57)</p>\n</li>\n<li><p><strong>aphisCore</strong> (<code>AQ</code> indicators): <strong>commonName</strong> (string, required, max 57), <strong>scientificName</strong> (object, optional), <strong>permit</strong> (object, optional: <code>typeCode</code> max 3 alphanumeric, <code>number</code> max 33)</p>\n</li>\n<li><p><strong>tsca</strong> (<code>EP7</code>): <strong>type</strong> (<code>Positive</code> or <code>Negative</code> certification), <strong>chemicalIdentity</strong> (object: <strong>type</strong> one of <code>Cas</code>, <code>TscaAccessionNumber</code>, <code>PremanufactureNotice</code>, <code>LowVolumeExemption</code>, <code>LowReleaseExposureExemption</code>, <code>TestMarketExemption</code>; <strong>value</strong> string, max 19)</p>\n</li>\n<li><p><strong>fishAndWildlife</strong> (<code>FW</code> indicators): <strong>countryOfTakingIso2Code</strong> (string, required), <strong>scientificName</strong> (object, required), <strong>commonName</strong> (string, required, max 57), <strong>permit</strong> (object, optional)</p>\n</li>\n</ul>\n<h4 id=\"enforcement\">Enforcement</h4>\n<ul>\n<li>From January 20, 2027 (or earlier, once the Entry Type 13 requirement is enabled for your account), packages failing the PGA rules are rejected (<code>207 Multi-Status</code>) with:<ul>\n<li><code>V_HtsCodeNotApprovedForShipping</code>: the HTS code is <code>NotApproved</code> for shipping (including codes with an open antidumping or countervailing duty case)</li>\n<li><code>V_ProductUseDisclaimersRequired</code>: a <code>ConditionallyApproved</code> code's required statements are missing from <code>pgaDataset.statements</code>; the message lists them</li>\n<li><code>V_PgaRequiredInformationMissing</code>: an agency filing is missing and the indicator was not disclaimed; the message names what each indicator accepts (e.g. <code>FD1 requires an FDA filing or the statements NotForMedicalUse and NotForFoodContact</code>)</li>\n<li><code>V_PgaProgramNotSupported</code>: the HTS code carries an indicator that can be neither filed nor disclaimed through this service (listed in <code>unsupportedIndicatorCodes</code> of <strong>Get HTS Code Requirements</strong>)</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"response\">Response</h2>\n<p><code>200 OK</code> when every package was saved, <code>207 Multi-Status</code> when at least one package was rejected (the others are saved).</p>\n<ul>\n<li><strong>packages</strong> (array): the saved packages<ul>\n<li><strong>id</strong> (uuid), <strong>trackingReference</strong>, <strong>clientId</strong> (your account id), <strong>shipmentId</strong> (uuid or <code>null</code> until the package is added to a container)</li>\n<li><strong>totalDeclaredValue</strong>, <strong>totalDutiesOwed</strong>, <strong>fee</strong> (USD)</li>\n<li><strong>createdAtUtc</strong> (date-time)</li>\n<li><strong>items</strong> (array): <strong>id</strong> (uuid), <strong>externalReference</strong>, <strong>htsCode</strong> (the 10-digit code duties were calculated with, or <code>null</code>), <strong>declaredHtsCode</strong> (the code you submitted), <strong>hasDeclaredHtsMismatch</strong> (<code>true</code> when classification resolved a different code than you declared), <strong>usedDeclaredHtsFallback</strong> (<code>true</code> when your declared code was used because classification could not resolve one)</li>\n</ul>\n</li>\n<li><strong>errors</strong> (array): one entry per rejected package<ul>\n<li><strong>reference</strong>: the package's tracking reference</li>\n<li><strong>errors</strong> (array): <strong>code</strong>, <strong>message</strong>, <strong>referenceValue</strong> (e.g. the item or value the error is about)</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<h3 id=\"400-bad-request-the-request-itself-is-invalid\">400 Bad Request: the request itself is invalid</h3>\n<p>Nothing is saved. The body lists every failed rule:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"errors\": [\n    {\n      \"fieldName\": \"Packages[0].Items[0].CountryOfOrigin\",\n      \"rejectedValue\": \"XX\",\n      \"code\": \"V_InvalidCountryCode\",\n      \"message\": \"Invalid ISO2 country code\"\n    }\n  ]\n}\n</code></pre>\n<ul>\n<li><strong>fieldName</strong>: path of the field in the request</li>\n<li><strong>rejectedValue</strong>: the submitted value (<code>null</code> for objects and missing values)</li>\n<li><strong>code</strong> / <strong>message</strong>: the rule that failed</li>\n</ul>\n<p>Common codes: <code>V_ValueEmpty</code>, <code>V_InvalidCountryCode</code>, <code>V_CountryOfOriginMismatch</code>, <code>V_InvalidLocale</code>, <code>V_InvalidEmail</code>, <code>V_InvalidTrackingReferenceFormat</code>, <code>V_MaxLengthExceeded</code>, <code>V_InvalidHtsCode</code>, <code>V_ExactlyOneValueRequired</code>, <code>V_ValueMustBeGreaterThanZero</code>, <code>V_ValueMustBeWholeNumber</code>, <code>V_MutuallyExclusiveProperties</code>, <code>V_DuplicateValuesNotAllowed</code>, <code>V_MaxImageCountExceeded</code>, <code>V_InvalidImageContent</code>, <code>V_MaxItemCountExceeded</code>, <code>V_InvalidCurrencyCode</code>, <code>V_InvalidAmountPrecision</code>, and the PGA field codes (<code>V_PgaDatasetEmpty</code>, <code>V_InvalidProductStatement</code>, <code>V_IntendedUseCodeNotAllowedForProgram</code>, ...).</p>\n<h3 id=\"207-multi-status-some-packages-were-rejected\">207 Multi-Status: some packages were rejected</h3>\n<p>Codes returned per package in <code>errors</code>:</p>\n<ul>\n<li><p><code>APP_HtsClassificationFailed</code>: no valid 10-digit HTS code could be resolved for an item</p>\n</li>\n<li><p><code>V_PackageDeclaredValueExceedsAllowedLimit</code>: the package's declared value exceeds $2,500</p>\n</li>\n<li><p><code>D_PackageReferenceAlreadyInUse</code>: the tracking reference belongs to another account's package</p>\n</li>\n<li><p><code>D_CannotEditContentOfPaidPackage</code>: the existing package with this tracking reference is already paid and cannot be changed</p>\n</li>\n<li><p><code>APP_CannotModifyPackageFromPreviousMonth</code>: the existing package was manifested in a previous month</p>\n</li>\n<li><p><code>D_PackageSubmittalsNotAccepted</code>: your account is not set up to submit packages through this endpoint</p>\n</li>\n<li><p>the PGA codes listed under <strong>Enforcement</strong> above</p>\n</li>\n<li><p><code>APP_InvalidCurrencyConversionRate</code>: no conversion rate is available for <code>inputCurrency</code> (returned for every package)</p>\n</li>\n</ul>\n<h3 id=\"404-not-found\">404 Not Found</h3>\n<p><code>RM_ClientNotFound</code> when the authenticated account is not known, or <code>D_DataProviderNotAllowedForShipper</code> when the <code>dataProviderCode</code> is not enabled for your account.</p>\n<h2 id=\"business-rules\">Business Rules</h2>\n<ul>\n<li>Tracking references must be unique system-wide</li>\n<li>Each package must have at least one item</li>\n<li>Declared values must be greater than zero, except on return items</li>\n<li>Country codes must be valid ISO 3166-1 alpha-2 codes</li>\n<li>Duties are automatically calculated based on HTS code, origin country, declared value and quantities</li>\n</ul>\n","urlObject":{"path":["api","v1","packages"],"host":["https://dutycollection.safepackage.com"],"query":[],"variable":[]}},"response":[{"id":"eb6d9532-dfe4-4f44-a26f-b4fdead98fbf","name":"Successful Package Creation","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"inputCurrency\": \"USD\",\n    \"packages\": [\n        {\n            \"trackingReference\": \"US123456789US\",\n            \"classificationType\": \"Regular\",\n            \"sender\": {\n                \"fullName\": \"John Doe\",\n                \"email\": \"john.doe@example.com\",\n                \"address\": {\n                    \"addressLine\": \"1 Example Street\",\n                    \"city\": \"Example City\",\n                    \"zipCode\": \"00000\",\n                    \"countryIso2Code\": \"JP\"\n                }\n            },\n            \"consignee\": {\n                \"fullName\": \"Jane Doe\",\n                \"address\": {\n                    \"addressLine\": \"2 Example Avenue\",\n                    \"city\": \"Springfield\",\n                    \"state\": \"IL\",\n                    \"zipCode\": \"00000\",\n                    \"countryIso2Code\": \"US\"\n                }\n            },\n            \"items\": [\n                {\n                    \"externalReference\": \"SKU-0001\",\n                    \"images\": [\n                        {\n                            \"reference\": \"IMG-0001\",\n                            \"base64Content\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=\"\n                        }\n                    ],\n                    \"countryOfOrigin\": \"CN\",\n                    \"totalDeclaredValue\": 77.97,\n                    \"description\": \"Men's knitted cotton t-shirt, short sleeve\",\n                    \"htsCode\": \"6109.10.00.12\",\n                    \"quantity\": 3,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 0.6,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ]\n                },\n                {\n                    \"externalReference\": \"SKU-0002\",\n                    \"manufacturer\": {\n                        \"businessName\": \"Example Ceramics Co.\",\n                        \"address\": {\n                            \"addressLine\": \"3 Example Road\",\n                            \"city\": \"Example City\",\n                            \"countryIso2Code\": \"JP\"\n                        }\n                    },\n                    \"singleUnitDeclaredValue\": 45.5,\n                    \"description\": \"Ceramic coffee mug, hand painted\",\n                    \"htsCode\": \"6912.00.44.00\",\n                    \"quantity\": 2,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 1.4,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ],\n                    \"pgaDataset\": {\n                        \"statements\": [\n                            \"NotForMedicalUse\"\n                        ],\n                        \"fda\": {\n                            \"program\": \"FoodContact\",\n                            \"intendedUseCode\": \"FoodAdditiveOrFoodContactSubstance\",\n                            \"productCode\": \"23FGH07\",\n                            \"countryOfProductionIso2Code\": \"JP\",\n                            \"tradeBrandName\": \"Example Brand\",\n                            \"productSpecificDescription\": \"Hand painted ceramic coffee mug, 350 ml\",\n                            \"packagingLevels\": [\n                                {\n                                    \"quantity\": 1,\n                                    \"unitCode\": \"BX\"\n                                },\n                                {\n                                    \"quantity\": 2,\n                                    \"unitCode\": \"PCS\"\n                                }\n                            ]\n                        }\n                    }\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"CN987654321CN\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"DE\",\n                    \"totalDeclaredValue\": 75.0,\n                    \"description\": \"Leather wallet, bovine\",\n                    \"htsCode\": \"4202.31.60.00\",\n                    \"quantity\": 1,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 0.2,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/packages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"packages\": [\n    {\n      \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\",\n      \"trackingReference\": \"US123456789US\",\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"shipmentId\": null,\n      \"totalDeclaredValue\": 168.97,\n      \"totalDutiesOwed\": 21.97,\n      \"fee\": 2.5,\n      \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\",\n      \"items\": [\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c111\",\n          \"externalReference\": \"SKU-0001\",\n          \"htsCode\": \"6109100012\",\n          \"declaredHtsCode\": \"6109100012\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        },\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c112\",\n          \"externalReference\": \"SKU-0002\",\n          \"htsCode\": \"6912004400\",\n          \"declaredHtsCode\": \"6912004400\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        }\n      ]\n    },\n    {\n      \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c102\",\n      \"trackingReference\": \"CN987654321CN\",\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"shipmentId\": null,\n      \"totalDeclaredValue\": 75.0,\n      \"totalDutiesOwed\": 6.0,\n      \"fee\": 2.5,\n      \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\",\n      \"items\": [\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c121\",\n          \"externalReference\": null,\n          \"htsCode\": \"4202316000\",\n          \"declaredHtsCode\": \"4202316000\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        }\n      ]\n    }\n  ],\n  \"errors\": []\n}"},{"id":"b9214607-2324-4517-8515-2576ffbae1e0","name":"Successful Creation with PGA Data (Entry Type 13)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"packages\": [\n        {\n            \"trackingReference\": \"FR555666777FR\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"FR\",\n                    \"totalDeclaredValue\": 60.0,\n                    \"description\": \"Matte lipstick, cosmetic lip make-up\",\n                    \"htsCode\": \"3304.10.00.00\",\n                    \"quantity\": 5,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 0.1,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ],\n                    \"pgaDataset\": {\n                        \"statements\": [\n                            \"ForExternalUseOnly\"\n                        ],\n                        \"fda\": {\n                            \"intendedUseCode\": \"ConsumerUse\",\n                            \"productCode\": \"53LY99\",\n                            \"countryOfProductionIso2Code\": \"FR\",\n                            \"tradeBrandName\": \"Example Cosmetics\",\n                            \"productSpecificDescription\": \"Matte lipstick, 3.5 g\",\n                            \"packagingLevels\": [\n                                {\n                                    \"quantity\": 1,\n                                    \"unitCode\": \"BX\"\n                                },\n                                {\n                                    \"quantity\": 5,\n                                    \"unitCode\": \"PCS\"\n                                }\n                            ]\n                        }\n                    }\n                },\n                {\n                    \"countryOfOrigin\": \"CN\",\n                    \"totalDeclaredValue\": 38.5,\n                    \"description\": \"Wooden toy building blocks for children, set of 50\",\n                    \"htsCode\": \"9503.00.00.73\",\n                    \"quantity\": 1,\n                    \"pgaDataset\": {\n                        \"cpsc\": {\n                            \"registryReference\": {\n                                \"certifierId\": \"EXAMPLE-CERTIFIER\",\n                                \"productId\": \"EXAMPLE-PRODUCT\",\n                                \"versionId\": \"1\"\n                            }\n                        },\n                        \"laceyAct\": {\n                            \"countryOfHarvestIso2Code\": \"CN\",\n                            \"scientificName\": {\n                                \"genus\": \"Pinus\",\n                                \"species\": \"massoniana\"\n                            },\n                            \"commonName\": \"Masson pine\"\n                        }\n                    }\n                },\n                {\n                    \"countryOfOrigin\": \"FR\",\n                    \"totalDeclaredValue\": 24.0,\n                    \"description\": \"Polypropylene storage boxes for tools, set of 4\",\n                    \"htsCode\": \"3924.10.40.00\",\n                    \"quantity\": 1,\n                    \"pgaDataset\": {\n                        \"statements\": [\n                            \"NotForMedicalUse\",\n                            \"NotForFoodContact\"\n                        ]\n                    }\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/packages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"packages\": [\n    {\n      \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c201\",\n      \"trackingReference\": \"FR555666777FR\",\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"shipmentId\": null,\n      \"totalDeclaredValue\": 122.5,\n      \"totalDutiesOwed\": 0.82,\n      \"fee\": 2.5,\n      \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\",\n      \"items\": [\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c211\",\n          \"externalReference\": null,\n          \"htsCode\": \"3304100000\",\n          \"declaredHtsCode\": \"3304100000\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        },\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c212\",\n          \"externalReference\": null,\n          \"htsCode\": \"9503000073\",\n          \"declaredHtsCode\": \"9503000073\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        },\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c213\",\n          \"externalReference\": null,\n          \"htsCode\": \"3924104000\",\n          \"declaredHtsCode\": \"3924104000\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        }\n      ]\n    }\n  ],\n  \"errors\": []\n}"},{"id":"7780097f-b004-4613-83d2-c11dea91d79d","name":"Partial Success with Errors","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"packages\": [\n        {\n            \"trackingReference\": \"CN987654321CN\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"DE\",\n                    \"totalDeclaredValue\": 75.0,\n                    \"description\": \"Leather wallet, bovine\",\n                    \"htsCode\": \"4202.31.60.00\",\n                    \"quantity\": 1,\n                    \"customsQuantities\": [\n                        {\n                            \"value\": 0.2,\n                            \"unitOfMeasure\": \"Kg\"\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"US222222222US\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"CN\",\n                    \"totalDeclaredValue\": 15.0,\n                    \"description\": \"Misc\",\n                    \"htsCode\": \"6912\",\n                    \"quantity\": 1\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"US333333333US\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"CN\",\n                    \"totalDeclaredValue\": 2600.0,\n                    \"description\": \"Mechanical wristwatch, stainless steel case\",\n                    \"htsCode\": \"9102.11.25.10\",\n                    \"quantity\": 1\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/packages"},"status":"Multi-Status","code":207,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"packages\": [\n    {\n      \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c102\",\n      \"trackingReference\": \"CN987654321CN\",\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"shipmentId\": null,\n      \"totalDeclaredValue\": 75.0,\n      \"totalDutiesOwed\": 6.0,\n      \"fee\": 2.5,\n      \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\",\n      \"items\": [\n        {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c121\",\n          \"externalReference\": null,\n          \"htsCode\": \"4202316000\",\n          \"declaredHtsCode\": \"4202316000\",\n          \"hasDeclaredHtsMismatch\": false,\n          \"usedDeclaredHtsFallback\": false\n        }\n      ]\n    }\n  ],\n  \"errors\": [\n    {\n      \"reference\": \"US222222222US\",\n      \"errors\": [\n        {\n          \"code\": \"APP_HtsClassificationFailed\",\n          \"message\": \"The HTS code could not be resolved from the item description and the package was not filed with CBP (status: needs_input; hts: '691200'; description: 'Misc')\",\n          \"referenceValue\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c131\"\n        }\n      ]\n    },\n    {\n      \"reference\": \"US333333333US\",\n      \"errors\": [\n        {\n          \"code\": \"V_PackageDeclaredValueExceedsAllowedLimit\",\n          \"message\": \"Total Declared Value for this package (sum of all items) exceeds $2,500. No action required.\",\n          \"referenceValue\": null\n        }\n      ]\n    }\n  ]\n}"},{"id":"2c5a8875-63d5-40eb-b0f0-f1fa28d41327","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"packages\": [\n        {\n            \"trackingReference\": \"INVALID_REF\",\n            \"items\": [\n                {\n                    \"countryOfOrigin\": \"XX\",\n                    \"totalDeclaredValue\": 10.0,\n                    \"declaredValue\": 10.0,\n                    \"description\": \"Cotton scarf\",\n                    \"quantity\": 1.5\n                },\n                {\n                    \"countryOfOrigin\": \"CN\",\n                    \"description\": \"Cotton socks\",\n                    \"totalDeclaredValue\": 8.0,\n                    \"manufacturer\": {\n                        \"address\": {\n                            \"countryIso2Code\": \"VN\"\n                        }\n                    }\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/packages"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"Packages[0].TrackingReference\",\n      \"rejectedValue\": \"INVALID_REF\",\n      \"code\": \"V_InvalidTrackingReferenceFormat\",\n      \"message\": \"Tracking reference must be a valid S10 or USPS IMPB format\"\n    },\n    {\n      \"fieldName\": \"Packages[0].Items[0].CountryOfOrigin\",\n      \"rejectedValue\": \"XX\",\n      \"code\": \"V_InvalidCountryCode\",\n      \"message\": \"Invalid ISO2 country code\"\n    },\n    {\n      \"fieldName\": \"Packages[0].Items[0].DeclaredValue\",\n      \"rejectedValue\": \"10.0\",\n      \"code\": \"V_ExactlyOneValueRequired\",\n      \"message\": \"Exactly one of the mutually exclusive properties must be populated\"\n    },\n    {\n      \"fieldName\": \"Packages[0].Items[0].Quantity\",\n      \"rejectedValue\": \"1.5\",\n      \"code\": \"V_ValueMustBeWholeNumber\",\n      \"message\": \"Value must be a whole number\"\n    },\n    {\n      \"fieldName\": \"Packages[0].Items[1].CountryOfOrigin\",\n      \"rejectedValue\": \"CN\",\n      \"code\": \"V_CountryOfOriginMismatch\",\n      \"message\": \"countryOfOrigin must match manufacturer.address.countryIso2Code when both are supplied\"\n    }\n  ]\n}"}],"_postman_id":"4f83ed5a-fc23-4eeb-8ff5-4efdd35e2f2a"},{"name":"Find Package","id":"230ef8fd-395b-4527-b019-ab3d89b23de6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","description":"<p>JWT token for authentication</p>\n"}],"url":"https://dutycollection.safepackage.com/api/v1/packages/find?value=EX000000001JP","description":"<h1 id=\"find-package\">Find Package</h1>\n<p>Looks up one of your packages by its package id or its tracking number and returns its label status, declared value and duties.</p>\n<h2 id=\"query-parameters\">Query Parameters</h2>\n<ul>\n<li><strong>value</strong> (string, required): the package id (uuid) or the tracking number of the package<ul>\n<li>Max 50 characters; surrounding whitespace is ignored; matching is exact</li>\n<li>Only packages submitted by your account are found</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"response\">Response</h2>\n<p><code>200 OK</code> with the package:</p>\n<ul>\n<li><strong>id</strong> (uuid): package id</li>\n<li><strong>declarationId</strong> (string or <code>null</code>): the package's declaration id; <code>null</code> for packages that have none</li>\n<li><strong>trackingNumber</strong> (string or <code>null</code>): the package's tracking number</li>\n<li><strong>label</strong> (object):<ul>\n<li><strong>status</strong> (enum): <code>NoLabel</code> (no label generated), <code>Valid</code> (a label exists and can be used) or <code>Expired</code> (the label is no longer valid)</li>\n<li><strong>createdAtUtc</strong> (date-time or <code>null</code>): when the label was generated</li>\n</ul>\n</li>\n<li><strong>shipmentId</strong> (uuid or <code>null</code>): the shipment the package is assigned to</li>\n<li><strong>createdAtUtc</strong> (date-time): when the package was created</li>\n<li><strong>totalDeclaredValue</strong> (number): declared value of the package, USD</li>\n<li><strong>totalDutiesOwed</strong> (number): duties owed for the package, USD</li>\n<li><strong>items</strong> (array):<ul>\n<li><strong>id</strong> (uuid), <strong>externalReference</strong> (your reference or <code>null</code>)</li>\n<li><strong>htsCode</strong> (string or <code>null</code>): the 10-digit code duties were calculated with</li>\n<li><strong>declaredHtsCode</strong> (string or <code>null</code>): the code you submitted</li>\n<li><strong>totalDeclaredValue</strong> (number): declared value of the whole item line (all units), USD</li>\n<li><strong>totalDutiesOwed</strong> (number): duties owed for the whole item line, USD</li>\n<li><strong>countryOfOrigin</strong> (string or <code>null</code>): ISO 3166-1 alpha-2 code</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<ul>\n<li><strong>400 Bad Request</strong>: <code>value</code> is empty (<code>V_ValueEmpty</code>) or longer than 50 characters (<code>V_MaxLengthExceeded</code>)</li>\n<li><strong>404 Not Found</strong>: none of your packages has this id or tracking number (<code>RM_PackageNotFound</code>, <code>referenceValue</code> = the searched value)</li>\n</ul>\n","urlObject":{"path":["api","v1","packages","find"],"host":["https://dutycollection.safepackage.com"],"query":[{"description":{"content":"<p>Package id (uuid) or tracking number, max 50 characters</p>\n","type":"text/plain"},"key":"value","value":"EX000000001JP"}],"variable":[]}},"response":[{"id":"00618e18-ac5e-4acd-a34f-ef4101f19c24","name":"Package Found","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/find?value=EX000000001JP","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages","find"],"query":[{"key":"value","value":"EX000000001JP","description":"Package id (uuid) or tracking number, max 50 characters"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301\",\n  \"declarationId\": \"EXAMPLE000001\",\n  \"trackingNumber\": \"EX000000001JP\",\n  \"label\": {\n    \"status\": \"Valid\",\n    \"createdAtUtc\": \"2026-11-10T11:02:41.512Z\"\n  },\n  \"shipmentId\": null,\n  \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\",\n  \"totalDeclaredValue\": 168.97,\n  \"totalDutiesOwed\": 21.97,\n  \"items\": [\n    {\n      \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c311\",\n      \"externalReference\": \"SKU-0001\",\n      \"htsCode\": \"6109100012\",\n      \"declaredHtsCode\": \"6109100012\",\n      \"totalDeclaredValue\": 77.97,\n      \"totalDutiesOwed\": 12.87,\n      \"countryOfOrigin\": \"CN\"\n    },\n    {\n      \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c312\",\n      \"externalReference\": \"SKU-0002\",\n      \"htsCode\": \"6912004400\",\n      \"declaredHtsCode\": \"6912004400\",\n      \"totalDeclaredValue\": 91.0,\n      \"totalDutiesOwed\": 9.1,\n      \"countryOfOrigin\": \"JP\"\n    }\n  ]\n}"},{"id":"fcb7592e-d88b-49f4-8e18-03d0eb6f841e","name":"Empty Value","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/find?value=","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages","find"],"query":[{"key":"value","value":"","description":"Package id (uuid) or tracking number, max 50 characters"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"Value\",\n      \"rejectedValue\": \"\",\n      \"code\": \"V_ValueEmpty\",\n      \"message\": \"Value cannot be empty\"\n    }\n  ]\n}"},{"id":"64e6d7bd-c189-46b0-8bee-ac7003087a19","name":"Package Not Found","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/find?value=EX000000009JP","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages","find"],"query":[{"key":"value","value":"EX000000009JP","description":"Package id (uuid) or tracking number, max 50 characters"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"RM_PackageNotFound\",\n      \"message\": \"Package not found\",\n      \"referenceValue\": \"EX000000009JP\",\n      \"itemIndex\": null\n    }\n  ]\n}"}],"_postman_id":"230ef8fd-395b-4527-b019-ab3d89b23de6"},{"name":"Generate Package Label","id":"ba01322f-1bb8-43bb-9f5a-9b4d915b5b3d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer ","description":"<p>JWT token for authentication</p>\n"}],"body":{"mode":"raw","raw":"{\n    \"consignee\": {\n        \"fullName\": \"Jane Doe\",\n        \"phoneNumber\": \"+1 555 000 0000\",\n        \"address\": {\n            \"addressLine\": \"2 Example Avenue\",\n            \"city\": \"Springfield\",\n            \"state\": \"IL\",\n            \"zipCode\": \"00000\",\n            \"countryIso2Code\": \"US\"\n        }\n    },\n    \"sender\": {\n        \"fullName\": \"John Doe\",\n        \"phoneNumber\": \"+81 3 0000 0000\",\n        \"address\": {\n            \"addressLine\": \"1 Example Street\",\n            \"addressLine2\": \"Room 101\",\n            \"city\": \"Example City\",\n            \"state\": \"Tokyo\",\n            \"zipCode\": \"000-0000\",\n            \"countryIso2Code\": \"JP\"\n        }\n    },\n    \"packageWeight\": {\n        \"value\": 1.2,\n        \"unitOfMeasure\": \"Kilograms\"\n    },\n    \"shipment\": {\n        \"sendType\": \"1\"\n    },\n    \"packageInfo\": {\n        \"printInvoice\": true,\n        \"invoiceCopies\": 2\n    },\n    \"items\": [\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c311\",\n            \"ndgReason\": \"without_lithium_battery\"\n        },\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c312\",\n            \"ndgReason\": \"other\",\n            \"ndgOtherText\": \"Ceramic, no batteries\"\n        }\n    ],\n    \"laterPayNumber\": \"1234567890-123456-1234567890-123456\"\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","description":"<h1 id=\"generate-package-label\">Generate Package Label</h1>\n<p>Generates the shipping label of one of your packages with the carrier and returns the label file directly. Available to accounts that ship through Japan Post: the label is issued by Japan Post, which also issues the package's tracking number.</p>\n<p>The contacts and weight sent in the body are used for the label and are saved on the package only when the label is generated successfully. A <code>consignee</code>, <code>sender</code> or <code>packageWeight</code> object you send replaces the stored one as a whole: fields left <code>null</code> or omitted inside it are cleared, not kept. Omit the whole object to use the stored data.</p>\n<h2 id=\"path-variables\">Path Variables</h2>\n<ul>\n<li><strong>id</strong> (uuid, required): the package id (as returned by <strong>Create Packages</strong> or <strong>Find Package</strong>)</li>\n</ul>\n<h2 id=\"request-body\">Request Body</h2>\n<p>All fields are optional; send <code>{}</code> to generate the label from the stored package data.</p>\n<ul>\n<li><strong>consignee</strong> (object): recipient contact</li>\n<li><strong>sender</strong> (object): sender contact. The sender e-mail stored on the package is kept<ul>\n<li>A contact carries <strong>fullName</strong>, <strong>companyName</strong>, <strong>email</strong>, <strong>phoneNumber</strong>, <strong>locale</strong> (IETF language tag such as <code>ja-JP</code>) and <strong>address</strong> (<strong>addressLine</strong>, <strong>addressLine2</strong>, <strong>city</strong>, <strong>state</strong>, <strong>zipCode</strong>, <strong>countryIso2Code</strong> (required, ISO 3166-1 alpha-2))</li>\n<li>Label text must be printable ASCII (<code>V_NonAsciiCharactersNotAllowed</code>). Max lengths: name 64 (sender) / 80 (recipient), company name 93 (name and company name together max 93), street and unit 64 / 80, city 36, state or prefecture 24 / 30, postal code 20, phone 20 (<code>V_MaxLengthExceeded</code>)</li>\n</ul>\n</li>\n<li><strong>packageWeight</strong> (object): <strong>value</strong> (number) and <strong>unitOfMeasure</strong> (<code>Kilograms</code>, <code>Pounds</code> or <code>Grams</code>). Max 30 kg, max 2 kg for send types <code>8</code> and <code>9</code></li>\n<li><strong>shipment</strong> (object): Japan Post shipping options<ul>\n<li><strong>sendType</strong>: <code>1</code> EMS (goods, default), <code>5</code> international parcel, <code>8</code> international air packet, <code>9</code> small packet</li>\n<li><strong>transType</strong>: shipping method <code>1</code> air, <code>2</code> surface, <code>3</code> SAL; required for send types <code>5</code> and <code>9</code></li>\n<li><strong>senderInstruction</strong>: what to do when the item cannot be delivered: <code>1</code> return, <code>3</code> forward, <code>4</code> abandon; required for send type <code>5</code></li>\n<li><strong>forwardTransType</strong>: return transport <code>1</code> air or <code>4</code> most economical route; required with sender instruction <code>1</code> on send type <code>5</code>, not allowed with sender instruction <code>3</code></li>\n</ul>\n</li>\n<li><strong>packageInfo</strong> (object): Japan Post package options<ul>\n<li><strong>insuredValue</strong> (integer, yen): only for send types <code>1</code> and <code>5</code>, max 2,000,000 and not above the declared value of the contents</li>\n<li><strong>printInvoice</strong> (boolean): also print a commercial invoice with the label; only for send types <code>1</code> and <code>5</code></li>\n<li><strong>invoiceCopies</strong> (integer): number of invoice copies, 1 to 10; only together with <code>printInvoice: true</code></li>\n<li><strong>nonCommercial</strong>, <strong>contentType</strong>, <strong>payCondition</strong>, <strong>customsRemarks</strong>, <strong>licenceNum</strong>, <strong>certNum</strong>, <strong>taxCode</strong>, <strong>invoiceNum</strong>, <strong>senderReference</strong>, <strong>csNumber</strong>: Japan Post label fields, passed on as given</li>\n</ul>\n</li>\n<li><strong>items</strong> (array): per-item instructions<ul>\n<li><strong>itemId</strong> (uuid, required): the item's id</li>\n<li><strong>ndgReason</strong> (string): non-dangerous goods reason printed for the item: <code>without_lithium_battery</code>, <code>lithium_battery_in_equipment</code>, <code>alcohol_24_or_less</code>, <code>without_gas</code>, <code>without_oil</code>, <code>not_applicable</code> or <code>other</code></li>\n<li><strong>ndgOtherText</strong> (string): the reason text printed when <code>ndgReason</code> is <code>other</code>; max 60 printable ASCII characters</li>\n</ul>\n</li>\n<li><strong>laterPayNumber</strong> (string): your own Japan Post later-pay (後納) customer number, to bill the postage to your Japan Post account<ul>\n<li>32 digits, either unbroken or grouped 10-6-10-6 with one kind of separator (<code>-</code> or space), e.g. <code>1234567890-123456-1234567890-123456</code></li>\n<li>Omit it or leave it blank to pay as usual</li>\n<li>The number is passed to Japan Post only and is not stored</li>\n</ul>\n</li>\n</ul>\n<h2 id=\"response\">Response</h2>\n<p><code>200 OK</code> with the label file as <code>application/pdf</code>. The response headers carry the identifiers printed on the label:</p>\n<ul>\n<li><strong>X-Tracking-Number</strong>: the tracking number issued by the carrier</li>\n<li><strong>X-Declaration-Id</strong>: the package's declaration id</li>\n<li>Each header is omitted when the package has no such value</li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<h3 id=\"400-bad-request-the-body-is-invalid\">400 Bad Request: the body is invalid</h3>\n<p>Body <code>{ \"errors\": [{ \"fieldName\", \"rejectedValue\", \"code\", \"message\" }] }</code>. Codes:</p>\n<ul>\n<li><code>V_InvalidLaterPayNumber</code>: <code>laterPayNumber</code> is not 32 digits in one of the accepted groupings</li>\n<li><code>V_InvalidJapanPostSendType</code>, <code>V_InvalidJapanPostTransType</code>, <code>V_JapanPostTransTypeRequiredForSendType</code>, <code>V_JapanPostSenderInstructionRequiredForSendType</code>, <code>V_JapanPostSenderInstructionNotSupported</code>, <code>V_JapanPostForwardTransTypeRequiredForSenderInstruction</code>, <code>V_JapanPostForwardTransTypeNotAllowedForSenderInstruction</code>, <code>V_JapanPostForwardTransTypeNotSupported</code></li>\n<li><code>V_JapanPostInsuranceNotAllowedForSendType</code>, <code>V_JapanPostInsuranceExceedsMaximum</code></li>\n<li><code>V_JapanPostInvoicePrintNotAllowedForSendType</code>, <code>V_JapanPostInvoiceCopiesOutOfRange</code>, <code>V_JapanPostInvoiceCopiesRequirePrintInvoice</code></li>\n<li><code>V_JapanPostMaxTotalWeightExceeded</code>, <code>V_JapanPostMaxTotalWeightForSendTypeExceeded</code></li>\n<li><code>V_InvalidJapanPostNdgReason</code>, <code>V_MaxLengthExceeded</code>, <code>V_NonAsciiCharactersNotAllowed</code></li>\n<li><code>V_InvalidCountryCode</code>, <code>V_InvalidLocale</code></li>\n</ul>\n<h3 id=\"404-not-found\">404 Not Found</h3>\n<p><code>RM_PackageNotFound</code>: your account is not the shipper of a package with this id.</p>\n<h3 id=\"409-conflict-the-label-cannot-be-generated\">409 Conflict: the label cannot be generated</h3>\n<p>Body <code>{ \"errors\": [{ \"code\", \"message\", \"referenceValue\", \"itemIndex\" }] }</code>; <code>referenceValue</code> names the field or value concerned, <code>itemIndex</code> the zero-based item for item errors. Codes:</p>\n<ul>\n<li><code>APP_CannotGenerateLabelForTrackedPackage</code>: the package already has a tracking number</li>\n<li><code>V_JapanPostInputCurrencyMustBeYen</code>: Japan Post labels can only be generated for packages declared in JPY</li>\n<li><code>V_JapanPostLabelFieldRequired</code>: data the label needs is missing (e.g. declaration id, package weight, sender or recipient name and address, sender state or prefecture, item description)</li>\n<li><code>V_JapanPostLabelItemDescriptionNotEnglish</code>: an item needs a description in English letters</li>\n<li><code>V_JapanPostDestinationNotAllowed</code>, <code>V_JapanPostSenderCountryMismatch</code>, <code>V_JapanPostOriginCountryNotAccepted</code>, <code>V_JapanPostLabelCountryUnknown</code>: country rules of the label</li>\n<li><code>V_JapanPostInsuredValueExceedsDeclaredValue</code>: the insured value is above the declared value of the contents</li>\n<li><code>APP_JapanPostRejectedLabel</code>: Japan Post rejected a field; the message names it</li>\n<li><code>V_InvalidLaterPayNumber</code>: Japan Post did not accept the later-pay number</li>\n<li><code>APP_JapanPostUnavailable</code>: Japan Post is temporarily unavailable; try again later</li>\n<li><code>APP_FailedToGenerateLabel</code>: labels cannot be generated for your account (it does not ship through Japan Post), or the carrier did not return a label</li>\n</ul>\n","urlObject":{"path":["api","v1","packages",":id","label"],"host":["https://dutycollection.safepackage.com"],"query":[],"variable":[{"id":"53538eca-a02f-46c7-8ea5-e53a2814b099","description":{"content":"<p>Package id (uuid)</p>\n","type":"text/plain"},"type":"any","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","key":"id"}]}},"response":[{"id":"86a786f9-908a-4e13-8782-02685ab778eb","name":"Label Generated (PDF)","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"consignee\": {\n        \"fullName\": \"Jane Doe\",\n        \"phoneNumber\": \"+1 555 000 0000\",\n        \"address\": {\n            \"addressLine\": \"2 Example Avenue\",\n            \"city\": \"Springfield\",\n            \"state\": \"IL\",\n            \"zipCode\": \"00000\",\n            \"countryIso2Code\": \"US\"\n        }\n    },\n    \"sender\": {\n        \"fullName\": \"John Doe\",\n        \"phoneNumber\": \"+81 3 0000 0000\",\n        \"address\": {\n            \"addressLine\": \"1 Example Street\",\n            \"addressLine2\": \"Room 101\",\n            \"city\": \"Example City\",\n            \"state\": \"Tokyo\",\n            \"zipCode\": \"000-0000\",\n            \"countryIso2Code\": \"JP\"\n        }\n    },\n    \"packageWeight\": {\n        \"value\": 1.2,\n        \"unitOfMeasure\": \"Kilograms\"\n    },\n    \"shipment\": {\n        \"sendType\": \"1\"\n    },\n    \"packageInfo\": {\n        \"printInvoice\": true,\n        \"invoiceCopies\": 2\n    },\n    \"items\": [\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c311\",\n            \"ndgReason\": \"without_lithium_battery\"\n        },\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c312\",\n            \"ndgReason\": \"other\",\n            \"ndgOtherText\": \"Ceramic, no batteries\"\n        }\n    ],\n    \"laterPayNumber\": \"1234567890-123456-1234567890-123456\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages",":id","label"],"variable":[{"key":"id","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","description":"Package id (uuid)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"text","header":[{"key":"Content-Type","value":"application/pdf"},{"key":"Content-Disposition","value":"attachment; filename=japanpost-label-0198c5a07b3e7f219c443d2a91b0f001.pdf"},{"key":"X-Tracking-Number","value":"EX000000001JP"},{"key":"X-Declaration-Id","value":"EXAMPLE000001"}],"cookie":[],"responseTime":null,"body":"%PDF-1.7\n... label file (binary content) ..."},{"id":"6518f590-c1a5-4eae-bb15-1a860bd4d0e7","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"shipment\": {\n        \"sendType\": \"7\"\n    },\n    \"laterPayNumber\": \"12345\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages",":id","label"],"variable":[{"key":"id","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","description":"Package id (uuid)"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"Body.LaterPayNumber\",\n      \"rejectedValue\": null,\n      \"code\": \"V_InvalidLaterPayNumber\",\n      \"message\": \"Later-pay number must be 32 digits, optionally grouped 10-6-10-6 with one kind of separator (- or space)\"\n    },\n    {\n      \"fieldName\": \"Body.Shipment.SendType\",\n      \"rejectedValue\": \"7\",\n      \"code\": \"V_InvalidJapanPostSendType\",\n      \"message\": \"Send type is not a recognised Japan Post shipping-type code\"\n    }\n  ]\n}"},{"id":"9389bdfd-bbf3-44c3-8033-0a07939ff71d","name":"Package Not Found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"consignee\": {\n        \"fullName\": \"Jane Doe\",\n        \"phoneNumber\": \"+1 555 000 0000\",\n        \"address\": {\n            \"addressLine\": \"2 Example Avenue\",\n            \"city\": \"Springfield\",\n            \"state\": \"IL\",\n            \"zipCode\": \"00000\",\n            \"countryIso2Code\": \"US\"\n        }\n    },\n    \"sender\": {\n        \"fullName\": \"John Doe\",\n        \"phoneNumber\": \"+81 3 0000 0000\",\n        \"address\": {\n            \"addressLine\": \"1 Example Street\",\n            \"addressLine2\": \"Room 101\",\n            \"city\": \"Example City\",\n            \"state\": \"Tokyo\",\n            \"zipCode\": \"000-0000\",\n            \"countryIso2Code\": \"JP\"\n        }\n    },\n    \"packageWeight\": {\n        \"value\": 1.2,\n        \"unitOfMeasure\": \"Kilograms\"\n    },\n    \"shipment\": {\n        \"sendType\": \"1\"\n    },\n    \"packageInfo\": {\n        \"printInvoice\": true,\n        \"invoiceCopies\": 2\n    },\n    \"items\": [\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c311\",\n            \"ndgReason\": \"without_lithium_battery\"\n        },\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c312\",\n            \"ndgReason\": \"other\",\n            \"ndgOtherText\": \"Ceramic, no batteries\"\n        }\n    ],\n    \"laterPayNumber\": \"1234567890-123456-1234567890-123456\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages",":id","label"],"variable":[{"key":"id","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","description":"Package id (uuid)"}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"RM_PackageNotFound\",\n      \"message\": \"Package not found\",\n      \"referenceValue\": null,\n      \"itemIndex\": null\n    }\n  ]\n}"},{"id":"dce0b58f-83bc-43a3-820a-f02fb0d57f8c","name":"Package Already Has a Tracking Number","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"consignee\": {\n        \"fullName\": \"Jane Doe\",\n        \"phoneNumber\": \"+1 555 000 0000\",\n        \"address\": {\n            \"addressLine\": \"2 Example Avenue\",\n            \"city\": \"Springfield\",\n            \"state\": \"IL\",\n            \"zipCode\": \"00000\",\n            \"countryIso2Code\": \"US\"\n        }\n    },\n    \"sender\": {\n        \"fullName\": \"John Doe\",\n        \"phoneNumber\": \"+81 3 0000 0000\",\n        \"address\": {\n            \"addressLine\": \"1 Example Street\",\n            \"addressLine2\": \"Room 101\",\n            \"city\": \"Example City\",\n            \"state\": \"Tokyo\",\n            \"zipCode\": \"000-0000\",\n            \"countryIso2Code\": \"JP\"\n        }\n    },\n    \"packageWeight\": {\n        \"value\": 1.2,\n        \"unitOfMeasure\": \"Kilograms\"\n    },\n    \"shipment\": {\n        \"sendType\": \"1\"\n    },\n    \"packageInfo\": {\n        \"printInvoice\": true,\n        \"invoiceCopies\": 2\n    },\n    \"items\": [\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c311\",\n            \"ndgReason\": \"without_lithium_battery\"\n        },\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c312\",\n            \"ndgReason\": \"other\",\n            \"ndgOtherText\": \"Ceramic, no batteries\"\n        }\n    ],\n    \"laterPayNumber\": \"1234567890-123456-1234567890-123456\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages",":id","label"],"variable":[{"key":"id","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","description":"Package id (uuid)"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"APP_CannotGenerateLabelForTrackedPackage\",\n      \"message\": \"Cannot generate a label for a package that already has a tracking reference\",\n      \"referenceValue\": null,\n      \"itemIndex\": null\n    }\n  ]\n}"},{"id":"5058b6d3-79d6-4f33-bed3-49ef2f126946","name":"Label Data Missing","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages",":id","label"],"variable":[{"key":"id","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","description":"Package id (uuid)"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"V_JapanPostLabelFieldRequired\",\n      \"message\": \"Package weight is required for a Japan Post label\",\n      \"referenceValue\": \"PackageWeight\",\n      \"itemIndex\": null\n    },\n    {\n      \"code\": \"V_JapanPostLabelFieldRequired\",\n      \"message\": \"Recipient postal code is required for a Japan Post label\",\n      \"referenceValue\": \"Consignee.Address.ZipCode\",\n      \"itemIndex\": null\n    }\n  ]\n}"},{"id":"ccf15d06-6f30-4fa3-a2ee-e2f4e2ea9aeb","name":"Japan Post Unavailable","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"consignee\": {\n        \"fullName\": \"Jane Doe\",\n        \"phoneNumber\": \"+1 555 000 0000\",\n        \"address\": {\n            \"addressLine\": \"2 Example Avenue\",\n            \"city\": \"Springfield\",\n            \"state\": \"IL\",\n            \"zipCode\": \"00000\",\n            \"countryIso2Code\": \"US\"\n        }\n    },\n    \"sender\": {\n        \"fullName\": \"John Doe\",\n        \"phoneNumber\": \"+81 3 0000 0000\",\n        \"address\": {\n            \"addressLine\": \"1 Example Street\",\n            \"addressLine2\": \"Room 101\",\n            \"city\": \"Example City\",\n            \"state\": \"Tokyo\",\n            \"zipCode\": \"000-0000\",\n            \"countryIso2Code\": \"JP\"\n        }\n    },\n    \"packageWeight\": {\n        \"value\": 1.2,\n        \"unitOfMeasure\": \"Kilograms\"\n    },\n    \"shipment\": {\n        \"sendType\": \"1\"\n    },\n    \"packageInfo\": {\n        \"printInvoice\": true,\n        \"invoiceCopies\": 2\n    },\n    \"items\": [\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c311\",\n            \"ndgReason\": \"without_lithium_battery\"\n        },\n        {\n            \"itemId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c312\",\n            \"ndgReason\": \"other\",\n            \"ndgOtherText\": \"Ceramic, no batteries\"\n        }\n    ],\n    \"laterPayNumber\": \"1234567890-123456-1234567890-123456\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://dutycollection.safepackage.com/api/v1/packages/:id/label","host":["https://dutycollection.safepackage.com"],"path":["api","v1","packages",":id","label"],"variable":[{"key":"id","value":"0198c5a0-7b3e-7f21-9c44-3d2a91b0c301","description":"Package id (uuid)"}]}},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"APP_JapanPostUnavailable\",\n      \"message\": \"Japan Post is temporarily unavailable (maintenance). Try again later.\",\n      \"referenceValue\": null,\n      \"itemIndex\": null\n    }\n  ]\n}"}],"_postman_id":"ba01322f-1bb8-43bb-9f5a-9b4d915b5b3d"}],"id":"616b6b11-52db-41e4-9744-2ad4f7969a67","description":"<p>Package management operations for individual mail items with customs information.</p>\n","_postman_id":"616b6b11-52db-41e4-9744-2ad4f7969a67"},{"name":"Containers","item":[{"name":"Create Containers","id":"61965969-db05-498f-adc2-b006b8a4cf47","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                \"US123456789US\",\n                \"CN987654321CN\"\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                \"DE456789123DE\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/containers","description":"<h1 id=\"create-containers\">Create Containers</h1>\n<p>Adds packages you already submitted (through <strong>Create Packages</strong>) to containers. Each container carries an entry route; the packages are assigned to the shipment of that entry route and their duties are recalculated for its entry date.</p>\n<h2 id=\"request-body-fields\">Request Body Fields</h2>\n<h3 id=\"root-object\">Root Object</h3>\n<ul>\n<li><strong>containers</strong> (array, required): Collection of containers<ul>\n<li>Container tracking references must be unique within the request (<code>V_DuplicateValuesNotAllowed</code>)</li>\n</ul>\n</li>\n</ul>\n<h3 id=\"container-object\">Container Object</h3>\n<ul>\n<li><strong>trackingReference</strong> (string, required): Your identifier for the container, max 50 characters<ul>\n<li>Example: <code>CONT001-AA1234</code></li>\n<li>Recorded on every package of the container</li>\n</ul>\n</li>\n<li><strong>entryRoute</strong> (object, required): How and when the container arrives (see below)</li>\n<li><strong>packages</strong> (array of strings, required): Tracking references of the packages in the container<ul>\n<li>Must be tracking references of packages your account submitted</li>\n</ul>\n</li>\n</ul>\n<h3 id=\"entry-route-object\">Entry Route Object</h3>\n<ul>\n<li><strong>flightOrTripNumber</strong> (string, required): Transport identifier, letters and digits only (<code>V_InvalidFlightOrTripNumber</code>)<ul>\n<li>Air: flight number (e.g. <code>AA1234</code>, <code>DL53</code>)</li>\n<li>Sea: voyage number; Land: trip or route number</li>\n</ul>\n</li>\n<li><strong>transportType</strong> (string, required): <code>Air</code>, <code>Land</code> or <code>Sea</code></li>\n<li><strong>carrierCode</strong> (string, required): 2-character IATA airline code (uppercase letters or digits, e.g. <code>AA</code>, <code>DL</code>) or 4-letter SCAC code (uppercase, e.g. <code>MAEU</code>) (<code>V_InvalidCarrierCode</code>)</li>\n<li><strong>arrivalPortCode</strong> (string, required): 4-digit CBP port of entry code, e.g. <code>4701</code> (<code>V_InvalidCustomsPortCode</code>)</li>\n<li><strong>entryDate</strong> (string, conditional): Arrival date, <code>YYYY-MM-DD</code></li>\n<li><strong>entryTimestamp</strong> (string, conditional): Arrival date and time, ISO 8601 (e.g. <code>2026-11-16T10:30:00Z</code>)<ul>\n<li>One of <code>entryDate</code> or <code>entryTimestamp</code> is required (<code>V_ValueEmpty</code>); <code>entryTimestamp</code> wins when both are sent</li>\n</ul>\n</li>\n<li>Containers with the same entry route are assigned to the same shipment. Packages and shipments with an entry date in the previous month can still be submitted or changed until the 3rd of the current month (UTC); after that, and for any earlier month, they are rejected with <code>APP_CannotChangeShipmentForPackageFromPreviousMonth</code> or <code>APP_CannotModifyPackageFromPreviousMonth</code></li>\n</ul>\n<h2 id=\"response\">Response</h2>\n<p><code>200 OK</code> when every package was assigned, <code>207 Multi-Status</code> when at least one package could not be assigned (the others are).</p>\n<ul>\n<li><strong>containers</strong> (array): one entry per container<ul>\n<li><strong>clientId</strong> (uuid): your account id</li>\n<li><strong>trackingReference</strong>: the container reference</li>\n<li><strong>shipmentId</strong> (uuid): the shipment the packages were assigned to</li>\n<li><strong>packages</strong> (array of uuids): ids of the packages assigned and priced</li>\n</ul>\n</li>\n<li><strong>errors</strong> (array): one entry per failed container or package<ul>\n<li><strong>reference</strong>: the container reference or package tracking reference</li>\n<li><strong>errors</strong> (array): <strong>code</strong>, <strong>message</strong>, <strong>referenceValue</strong></li>\n</ul>\n</li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<h3 id=\"400-bad-request\">400 Bad Request</h3>\n<p>Invalid request; nothing is saved. Body <code>{ \"errors\": [{ \"fieldName\", \"rejectedValue\", \"code\", \"message\" }] }</code> with codes such as <code>V_ValueEmpty</code>, <code>V_MaxLengthExceeded</code>, <code>V_InvalidFlightOrTripNumber</code>, <code>V_InvalidCarrierCode</code>, <code>V_InvalidCustomsPortCode</code>, <code>V_DuplicateValuesNotAllowed</code>.</p>\n<h3 id=\"207-multi-status\">207 Multi-Status</h3>\n<p>Codes returned in <code>errors</code>:</p>\n<ul>\n<li><code>RM_PackageNotFound</code>: none of your packages has this tracking reference (<code>referenceValue</code> = the tracking reference)</li>\n<li><code>D_CannotAssignToShipmentWithoutCompletedPayment</code>: the package must be paid before it can be shipped</li>\n<li><code>D_CannotAssignToShipmentWithoutTrackingReference</code>: the package has no tracking reference</li>\n<li><code>APP_CannotModifyPackageFromPreviousMonth</code>, <code>APP_CannotChangeShipmentForPackageFromPreviousMonth</code>: the package or shipment was manifested in a previous month</li>\n<li>duty calculation errors (e.g. <code>APP_HtsClassificationFailed</code>) when a package could not be priced for the entry date</li>\n</ul>\n<h3 id=\"404-not-found\">404 Not Found</h3>\n<p><code>RM_ClientNotFound</code> when the authenticated account is not known. Nothing is saved.</p>\n<h3 id=\"409-conflict\">409 Conflict</h3>\n<p>The entry route of a container cannot be used and the request stops. No package is changed, but the shipments of containers listed before the failing one may already have been created; submitting the corrected request again reuses them:</p>\n<ul>\n<li><code>V_InvalidCustomsPortCode</code>: the arrival port code is not a known CBP port</li>\n<li><code>APP_CannotChangeShipmentForPackageFromPreviousMonth</code>: the entry date lies in a previous month that is already closed</li>\n</ul>\n<h2 id=\"business-rules\">Business Rules</h2>\n<ul>\n<li>Packages must exist before they are added to a container</li>\n<li>Container references must be unique within a request</li>\n<li>Port codes must be valid CBP ports of entry</li>\n</ul>\n","urlObject":{"path":["api","v1","containers"],"host":["https://dutycollection.safepackage.com"],"query":[],"variable":[]}},"response":[{"id":"870c0346-0a08-4298-b196-b3d3143e7a7c","name":"Successful Container Creation","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                \"US123456789US\",\n                \"CN987654321CN\"\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                \"DE456789123DE\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/containers"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"containers\": [\n    {\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"trackingReference\": \"CONT001-AA1234\",\n      \"shipmentId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n      \"packages\": [\n        \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\",\n        \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c102\"\n      ]\n    },\n    {\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"trackingReference\": \"CONT002-DL53\",\n      \"shipmentId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d102\",\n      \"packages\": [\n        \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c103\"\n      ]\n    }\n  ],\n  \"errors\": []\n}"},{"id":"3e6a888c-131e-4ea5-a348-6977f0bbaf9e","name":"Partial Success with Errors","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                \"US123456789US\",\n                \"CN987654321CN\"\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                \"DE456789123DE\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/containers"},"status":"Multi-Status","code":207,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"containers\": [\n    {\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"trackingReference\": \"CONT001-AA1234\",\n      \"shipmentId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n      \"packages\": [\n        \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\"\n      ]\n    },\n    {\n      \"clientId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0e001\",\n      \"trackingReference\": \"CONT002-DL53\",\n      \"shipmentId\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d102\",\n      \"packages\": []\n    }\n  ],\n  \"errors\": [\n    {\n      \"reference\": \"CONT002-DL53\",\n      \"errors\": [\n        {\n          \"code\": \"RM_PackageNotFound\",\n          \"message\": \"Package not found\",\n          \"referenceValue\": \"DE456789123DE\"\n        }\n      ]\n    },\n    {\n      \"reference\": \"CN987654321CN\",\n      \"errors\": [\n        {\n          \"code\": \"D_CannotAssignToShipmentWithoutCompletedPayment\",\n          \"message\": \"Cannot set shipment on a package that requires payment proof without a completed payment\",\n          \"referenceValue\": null\n        }\n      ]\n    }\n  ]\n}"},{"id":"413c8021-096a-4796-bafa-6404d7af4e86","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA-1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"aa\",\n                \"arrivalPortCode\": \"47011\"\n            },\n            \"packages\": [\n                \"US123456789US\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/containers"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.CarrierCode\",\n      \"rejectedValue\": \"aa\",\n      \"code\": \"V_InvalidCarrierCode\",\n      \"message\": \"Invalid carrier code format\"\n    },\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.FlightOrTripNumber\",\n      \"rejectedValue\": \"AA-1234\",\n      \"code\": \"V_InvalidFlightOrTripNumber\",\n      \"message\": \"Invalid flight or trip code format\"\n    },\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.ArrivalPortCode\",\n      \"rejectedValue\": \"47011\",\n      \"code\": \"V_InvalidCustomsPortCode\",\n      \"message\": \"Invalid customs port code\"\n    },\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.EntryDate\",\n      \"rejectedValue\": null,\n      \"code\": \"V_ValueEmpty\",\n      \"message\": \"Value cannot be empty\"\n    },\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.EntryTimestamp\",\n      \"rejectedValue\": null,\n      \"code\": \"V_ValueEmpty\",\n      \"message\": \"Value cannot be empty\"\n    }\n  ]\n}"},{"id":"18ec36c9-d967-4914-ba29-f8ce987ad5a7","name":"Client Not Found","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                \"US123456789US\",\n                \"CN987654321CN\"\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                \"DE456789123DE\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/containers"},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"RM_ClientNotFound\",\n      \"message\": \"Client not found\",\n      \"referenceValue\": null,\n      \"itemIndex\": null\n    }\n  ]\n}"},{"id":"141773bf-4768-4f90-933f-a9f33ed6d763","name":"Unknown Port of Entry","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"0000\",\n                \"entryDate\": \"2026-11-16\"\n            },\n            \"packages\": [\n                \"US123456789US\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/containers"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"V_InvalidCustomsPortCode\",\n      \"message\": \"Invalid customs port code\",\n      \"referenceValue\": null,\n      \"itemIndex\": null\n    }\n  ]\n}"}],"_postman_id":"61965969-db05-498f-adc2-b006b8a4cf47"}],"id":"7ce022da-372f-4e88-a95d-2977d809fcee","description":"<p>Container management for grouping packages with transport and entry route information.</p>\n","_postman_id":"7ce022da-372f-4e88-a95d-2977d809fcee"},{"name":"Duties","item":[{"name":"Calculate Duties","id":"12324718-c487-4da4-9000-d66439673e11","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"reference\": \"ITEM-001\",\n            \"countryCode\": \"CN\",\n            \"price\": 25.99,\n            \"quantity\": 3,\n            \"htsCode\": \"6109.10.00.12\",\n            \"weight\": {\n                \"value\": 0.2,\n                \"unitOfMeasure\": \"Kilograms\"\n            }\n        },\n        {\n            \"reference\": \"ITEM-002\",\n            \"countryCode\": \"JP\",\n            \"price\": 45.5,\n            \"quantity\": 2,\n            \"htsCode\": \"6912.00.44.00\"\n        },\n        {\n            \"reference\": \"ITEM-003\",\n            \"countryCode\": \"DE\",\n            \"price\": 75.0,\n            \"htsCode\": \"4908.90.00.00\"\n        }\n    ],\n    \"entryDate\": \"2026-11-16\",\n    \"classificationType\": \"Regular\",\n    \"paymentProcessor\": \"Stripe\"\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/duties/calculate","description":"<h1 id=\"calculate-duties\">Calculate Duties</h1>\n<p>Calculates customs duties for a collection of items without creating any records. Useful for duty estimates before submitting packages, e.g. during checkout.</p>\n<h2 id=\"request-body-fields\">Request Body Fields</h2>\n<h3 id=\"root-object\">Root Object</h3>\n<ul>\n<li><strong>items</strong> (array, required): Items to calculate duties for (min 1, <code>V_ValueEmpty</code>)</li>\n<li><strong>entryDate</strong> (string, optional): Date the items will enter the United States, <code>YYYY-MM-DD</code>. Defaults to today; selects the tariff rates in force on that date</li>\n<li><strong>classificationType</strong> (string, optional): <code>Regular</code> (default), <code>Gift</code> or <code>Return</code></li>\n<li><strong>paymentProcessor</strong> (string, optional): <code>Stripe</code>, <code>PayPal</code> or <code>LianLian</code> (<code>V_InvalidPaymentProcessor</code>). When sent, the response also contains <code>paymentCalculation</code> with your processing fee and the payment processor fee</li>\n</ul>\n<h3 id=\"item-object\">Item Object</h3>\n<ul>\n<li><strong>reference</strong> (string, optional): Your identifier for the item, max 100 characters, returned as <code>itemReference</code>. A generated id is used when omitted</li>\n<li><strong>countryCode</strong> (string, required): ISO 3166-1 alpha-2 code of the country of origin (<code>V_InvalidCountryCode</code>)</li>\n<li><strong>price</strong> (number, required): Declared value of <strong>one unit</strong>, USD, greater than 0 (<code>V_ValueMustBeGreaterThanZero</code>)</li>\n<li><strong>quantity</strong> (integer, optional): Number of units, greater than 0, default 1. Duties are calculated for <code>price × quantity</code></li>\n<li><strong>htsCode</strong> (string, optional): HTS code of the item, dotted or plain digits; submit the full 10-digit code for accurate rates</li>\n<li><strong>weight</strong> (object, optional): Weight of <strong>one unit</strong>: <strong>value</strong> (number) and <strong>unitOfMeasure</strong> (<code>Kilograms</code>, <code>Pounds</code> or <code>Grams</code>). Needed when the tariff bills on weight</li>\n</ul>\n<h2 id=\"response\">Response</h2>\n<ul>\n<li><strong>items</strong> (array): one entry per item<ul>\n<li><strong>itemReference</strong>, <strong>htsCode</strong>, <strong>countryCode</strong></li>\n<li><strong>price</strong>: the unit price sent</li>\n<li><strong>entryDate</strong>: the entry date used</li>\n<li><strong>tariffRatePercentage</strong>: duties as a percentage of the line value (<code>price × quantity</code>)</li>\n<li><strong>calculatedDuty</strong>: duties for the whole line, USD</li>\n</ul>\n</li>\n<li><strong>totalTariffValue</strong> (number): sum of <code>calculatedDuty</code>, USD</li>\n<li><strong>paymentCalculation</strong> (object or <code>null</code>): set when <code>paymentProcessor</code> was sent<ul>\n<li><strong>calculatedDuties</strong>, <strong>processingFee</strong>, <strong>paymentProcessorFee</strong>, <strong>totalAmount</strong> (numbers), <strong>paymentProcessor</strong>, <strong>currency</strong></li>\n</ul>\n</li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<ul>\n<li><strong>400 Bad Request</strong>: invalid request. Body <code>{ \"errors\": [{ \"fieldName\", \"rejectedValue\", \"code\", \"message\" }] }</code>, e.g. <code>V_ValueEmpty</code>, <code>V_MaxLengthExceeded</code>, <code>V_InvalidCountryCode</code>, <code>V_ValueMustBeGreaterThanZero</code>, <code>V_InvalidPaymentProcessor</code></li>\n<li><strong>404 Not Found</strong>: <code>RM_ClientNotFound</code> when the authenticated account is not known</li>\n<li><strong>409 Conflict</strong>: the duties could not be calculated. Body <code>{ \"errors\": [{ \"code\", \"message\", \"referenceValue\", \"itemIndex\" }] }</code>, e.g. <code>RM_CountryNotFound</code> (<code>The following countries were not found: XX</code>) or a duty calculation error for an item</li>\n</ul>\n<h2 id=\"business-rules\">Business Rules</h2>\n<ul>\n<li>Duty rates are determined by HTS code, country of origin, value, quantities and the trade policy in force on the entry date</li>\n<li>All amounts are in USD</li>\n<li>Results are valid for the specified entry date only</li>\n</ul>\n","urlObject":{"path":["api","v1","duties","calculate"],"host":["https://dutycollection.safepackage.com"],"query":[],"variable":[]}},"response":[{"id":"9907beea-28e4-48b9-9034-7dd9f8285e7d","name":"Successful Duty Calculation","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"reference\": \"ITEM-001\",\n            \"countryCode\": \"CN\",\n            \"price\": 25.99,\n            \"quantity\": 3,\n            \"htsCode\": \"6109.10.00.12\",\n            \"weight\": {\n                \"value\": 0.2,\n                \"unitOfMeasure\": \"Kilograms\"\n            }\n        },\n        {\n            \"reference\": \"ITEM-002\",\n            \"countryCode\": \"JP\",\n            \"price\": 45.5,\n            \"quantity\": 2,\n            \"htsCode\": \"6912.00.44.00\"\n        },\n        {\n            \"reference\": \"ITEM-003\",\n            \"countryCode\": \"DE\",\n            \"price\": 75.0,\n            \"htsCode\": \"4908.90.00.00\"\n        }\n    ],\n    \"entryDate\": \"2026-11-16\",\n    \"classificationType\": \"Regular\",\n    \"paymentProcessor\": \"Stripe\"\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/duties/calculate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"items\": [\n    {\n      \"itemReference\": \"ITEM-001\",\n      \"htsCode\": \"6109.10.00.12\",\n      \"countryCode\": \"CN\",\n      \"price\": 25.99,\n      \"entryDate\": \"2026-11-16\",\n      \"tariffRatePercentage\": 16.5,\n      \"calculatedDuty\": 12.87\n    },\n    {\n      \"itemReference\": \"ITEM-002\",\n      \"htsCode\": \"6912.00.44.00\",\n      \"countryCode\": \"JP\",\n      \"price\": 45.5,\n      \"entryDate\": \"2026-11-16\",\n      \"tariffRatePercentage\": 10.0,\n      \"calculatedDuty\": 9.1\n    },\n    {\n      \"itemReference\": \"ITEM-003\",\n      \"htsCode\": \"4908.90.00.00\",\n      \"countryCode\": \"DE\",\n      \"price\": 75.0,\n      \"entryDate\": \"2026-11-16\",\n      \"tariffRatePercentage\": 0.0,\n      \"calculatedDuty\": 0.0\n    }\n  ],\n  \"totalTariffValue\": 21.97,\n  \"paymentCalculation\": {\n    \"calculatedDuties\": 21.97,\n    \"processingFee\": 2.5,\n    \"paymentProcessorFee\": 1.08,\n    \"paymentProcessor\": \"Stripe\",\n    \"totalAmount\": 25.55,\n    \"currency\": \"USD\"\n  }\n}"},{"id":"123d0802-4c13-4ce0-a4ff-eedafdacf361","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"reference\": \"ITEM-001\",\n            \"countryCode\": \"CHN\",\n            \"price\": 0\n        }\n    ],\n    \"paymentProcessor\": \"Cash\"\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/duties/calculate"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"Body.PaymentProcessor\",\n      \"rejectedValue\": \"Cash\",\n      \"code\": \"V_InvalidPaymentProcessor\",\n      \"message\": \"Invalid payment processor\"\n    },\n    {\n      \"fieldName\": \"Body.Items[0].CountryCode\",\n      \"rejectedValue\": \"CHN\",\n      \"code\": \"V_InvalidCountryCode\",\n      \"message\": \"Invalid ISO2 country code\"\n    },\n    {\n      \"fieldName\": \"Body.Items[0].Price\",\n      \"rejectedValue\": \"0\",\n      \"code\": \"V_ValueMustBeGreaterThanZero\",\n      \"message\": \"Value must be greater than zero\"\n    }\n  ]\n}"},{"id":"63a7cb1d-da57-4b4d-aa06-aec4fb6d0570","name":"Unknown Country","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"items\": [\n        {\n            \"reference\": \"ITEM-001\",\n            \"countryCode\": \"XX\",\n            \"price\": 25.99\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/duties/calculate"},"status":"Conflict","code":409,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"RM_CountryNotFound\",\n      \"message\": \"The following countries were not found: XX\",\n      \"referenceValue\": null,\n      \"itemIndex\": null\n    }\n  ]\n}"}],"_postman_id":"12324718-c487-4da4-9000-d66439673e11"}],"id":"57fe9ceb-0e07-409c-965f-66d09cfd30b4","description":"<p>Duty calculation services for estimating customs duties without creating persistent records.</p>\n","_postman_id":"57fe9ceb-0e07-409c-965f-66d09cfd30b4"},{"name":"HTS","item":[{"name":"Get HTS Code Requirements","id":"30e0c89e-0b92-4043-be33-2106454cfb61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"Bearer ","description":"<p>JWT token for authentication</p>\n"}],"url":"https://dutycollection.safepackage.com/api/v1/hts/6101.30.15.00/requirements","description":"<h1 id=\"get-hts-code-requirements\">Get HTS Code Requirements</h1>\n<p>Returns everything an item classified under the given HTS code needs before it can be submitted: whether the code may be shipped at all, the data its duty calculation needs, and the PGA (Partner Government Agency, Entry Type 13) data its filing needs. Query it before submitting packages so you know up front which item fields to collect from the shipper.</p>\n<h2 id=\"path-parameters\">Path Parameters</h2>\n<ul>\n<li><strong>htsCode</strong> (string, required): the HTS code to query, dotted or plain digits (e.g. <code>6101.30.15.00</code> or <code>6101301500</code>)<ul>\n<li>A malformed code returns <code>400 Bad Request</code> with <code>V_InvalidHtsCode</code></li>\n<li>A code that does not resolve to a tariff schedule entry returns <code>404 Not Found</code> with <code>RM_HtsCodeNotFound</code></li>\n</ul>\n</li>\n</ul>\n<h2 id=\"query-parameters\">Query Parameters</h2>\n<ul>\n<li><strong>countryOfOrigin</strong> (string, optional): ISO 3166-1 alpha-2 code of the item's country of origin (e.g. <code>CN</code>)<ul>\n<li>When sent, <code>dutyCalculation.requiredQuantityUnits</code> lists the units required by the tariff rate that applies to that origin; without it, the units required by any rate of the code are returned</li>\n<li>An invalid code returns <code>400 Bad Request</code> with <code>V_InvalidCountryCode</code>; a country without tariff data returns <code>404 Not Found</code> with <code>RM_CountryNotFound</code></li>\n</ul>\n</li>\n</ul>\n<h2 id=\"how-to-read-the-response\">How to Read the Response</h2>\n<p>Work through the response top to bottom for every item:</p>\n<ol>\n<li><strong>Can the item ship at all?</strong> Check <code>shipmentApproval.approvedForShipping</code>.<ul>\n<li><code>NotApproved</code>: do not submit the item; it will be rejected.</li>\n<li><code>ConditionallyApproved</code>: the item ships only if the shipper confirms every statement in <code>shipmentApproval.disclaimersRequiredForShippingApproval</code>. Put each of them in the item's <code>pgaDataset.statements</code>. If the product does not match a statement (for example it <em>is</em> for medical use), the item cannot be shipped.</li>\n<li><code>Approved</code>: no shipping restriction.</li>\n</ul>\n</li>\n<li><strong>What does the duty calculation need?</strong> Read <code>dutyCalculation</code> and send the matching <code>customsQuantities</code> and <code>components</code> on the item.</li>\n<li><strong>What PGA data must the item carry?</strong> When <code>pga</code> is not <code>null</code>, read each agency object (<code>fda</code>, <code>cpsc</code>, <code>laceyAct</code>, <code>aphisCore</code>, <code>tsca</code>, <code>fishAndWildlife</code>):<ul>\n<li><code>NotRequired</code>: send nothing for that agency.</li>\n<li><code>Required</code>: send the agency's filing in the matching <code>pgaDataset</code> section.</li>\n<li><code>Conditional</code>: send <strong>either</strong> the agency's filing <strong>or</strong> every statement of one of the sets listed in <code>disclaimers</code> in <code>pgaDataset.statements</code>.</li>\n</ul>\n</li>\n<li><strong>Anything else?</strong> <code>pga.otherAgencies</code> covers indicators of agencies that have no filing section: when <code>Conditional</code>, declare one of its <code>disclaimers</code> statement sets. Codes in <code>pga.unsupportedIndicatorCodes</code> can be neither filed nor disclaimed through this service.</li>\n</ol>\n<h2 id=\"response-fields\">Response Fields</h2>\n<ul>\n<li><strong>htsCode</strong> (string): the queried code in dotted form</li>\n<li><strong>description</strong> (string): the full hierarchical tariff schedule description of the code</li>\n</ul>\n<h3 id=\"dutycalculation\">dutyCalculation</h3>\n<ul>\n<li><strong>requiresSpecificQuantityUnit</strong> (boolean): <code>true</code> when a rate on the code bills per unit (e.g. ¢/kg), so an accurate duty needs the item quantity expressed in one of the required units</li>\n<li><strong>requiredQuantityUnits</strong> (array of unit enums): the units a <code>customsQuantities</code> entry must supply. Values: <code>Kg</code>, <code>Number</code>, <code>Dozen</code>, <code>SquareMeter</code>, <code>CubicMeter</code>, <code>MetricTon</code>, <code>Liter</code>, <code>ProofLiter</code>, <code>Gram</code>, <code>Barrel</code>, <code>Gross</code>, <code>Pair</code>, <code>Per1000</code>. With <code>countryOfOrigin</code>, only the units of the rate that applies to that origin</li>\n<li><strong>acceptedQuantityUnits</strong> (array of unit enums): all units the tariff schedule lists for the code, same values as above</li>\n<li><strong>requiredComponents</strong> (array of strings): component HTS classifications CBP declares separately (e.g. watch movements); items under the code must submit a <code>components</code> entry per listed code</li>\n</ul>\n<h3 id=\"shipmentapproval\">shipmentApproval</h3>\n<p>Always present. Tells you whether an item under this code may be shipped.</p>\n<ul>\n<li><strong>approvedForShipping</strong> (enum):<ul>\n<li><code>Approved</code>: the code may be shipped. Codes with no PGA indicators are always <code>Approved</code></li>\n<li><code>ConditionallyApproved</code>: the code may be shipped only for products that meet the statements in <code>disclaimersRequiredForShippingApproval</code></li>\n<li><code>NotApproved</code>: the code cannot be shipped through this service. Items are rejected with <code>V_HtsCodeNotApprovedForShipping</code></li>\n</ul>\n</li>\n<li><strong>disclaimersRequiredForShippingApproval</strong> (array of product statements, or <code>null</code>): set only when <code>approvedForShipping</code> is <code>ConditionallyApproved</code>. Every value must appear in the item's <code>pgaDataset.statements</code>, otherwise the item is rejected with <code>V_ProductUseDisclaimersRequired</code>. Possible values:<ul>\n<li><code>NotForMedicalUse</code>: the product is not intended for medical use</li>\n<li><code>ForExternalUseOnly</code>: the product is for external use only</li>\n<li><code>NotFood</code>: the product is not a food. Food products cannot be shipped through this service</li>\n</ul>\n</li>\n<li><strong>subjectToAntidumpingDuty</strong> (boolean): an antidumping duty case is open for a related HTS code</li>\n<li><strong>subjectToCountervailingDuty</strong> (boolean): a countervailing duty case is open for a related HTS code<ul>\n<li>When either flag is <code>true</code>, <code>approvedForShipping</code> is always <code>NotApproved</code>, whatever the code's PGA status</li>\n</ul>\n</li>\n</ul>\n<h3 id=\"pga\">pga</h3>\n<p><code>null</code> when no PGA indicators are recorded for the code: no PGA data is needed. Otherwise an object with one entry per agency (always all six), plus <code>otherAgencies</code> and <code>unsupportedIndicatorCodes</code>:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Field</th>\n<th>Agency</th>\n<th>Filing section on the item</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><strong>fda</strong></td>\n<td>Food and Drug Administration</td>\n<td><code>pgaDataset.fda</code></td>\n</tr>\n<tr>\n<td><strong>cpsc</strong></td>\n<td>Consumer Product Safety Commission</td>\n<td><code>pgaDataset.cpsc</code></td>\n</tr>\n<tr>\n<td><strong>laceyAct</strong></td>\n<td>APHIS Lacey Act (plant products)</td>\n<td><code>pgaDataset.laceyAct</code></td>\n</tr>\n<tr>\n<td><strong>aphisCore</strong></td>\n<td>APHIS Core (plant and animal health)</td>\n<td><code>pgaDataset.aphisCore</code></td>\n</tr>\n<tr>\n<td><strong>tsca</strong></td>\n<td>EPA Toxic Substances Control Act</td>\n<td><code>pgaDataset.tsca</code></td>\n</tr>\n<tr>\n<td><strong>fishAndWildlife</strong></td>\n<td>U.S. Fish and Wildlife Service</td>\n<td><code>pgaDataset.fishAndWildlife</code></td>\n</tr>\n<tr>\n<td><strong>otherAgencies</strong></td>\n<td>Indicators of other agencies (e.g. USDA organic, DEA, TTB)</td>\n<td>statements only, in <code>pgaDataset.statements</code></td>\n</tr>\n</tbody>\n</table>\n</div><ul>\n<li><strong>unsupportedIndicatorCodes</strong> (array of strings): indicator codes on the HTS code that can be neither filed nor disclaimed through this service. Items under such a code are rejected with <code>V_PgaProgramNotSupported</code> once the PGA requirement applies</li>\n</ul>\n<p>Each agency object carries:</p>\n<ul>\n<li><strong>requirement</strong> (enum):<ul>\n<li><code>NotRequired</code>: the agency does not regulate this code; send nothing</li>\n<li><code>Required</code>: the item must carry the agency's filing. Statements cannot replace it</li>\n<li><code>Conditional</code>: the agency regulates some products under this code. Send the filing if your product is regulated, or disclaim it with one of the statement sets in <code>disclaimers</code></li>\n</ul>\n</li>\n<li><strong>disclaimers</strong> (array of statement sets, or <code>null</code>): set only when <code>requirement</code> is <code>Conditional</code>. Each inner array is one alternative: declaring <strong>every</strong> statement of <strong>any one</strong> set in <code>pgaDataset.statements</code> disclaims the agency, so no filing is needed<ul>\n<li><code>[[\"NotForFoodContact\"]]</code>: one way to disclaim: declare <code>NotForFoodContact</code></li>\n<li><code>[[\"NotForMedicalUse\", \"NotFood\"]]</code>: declare both statements</li>\n<li><code>[[\"ContainsNoPlantMaterial\"], [\"PlantMaterialDeMinimis\"]]</code>: declare either one</li>\n</ul>\n</li>\n<li><strong>program</strong> (<code>fda</code> only; enum or <code>null</code>): <code>FoodContact</code> or <code>Cosmetics</code> when the tariff line settles the FDA program; use it as <code>pgaDataset.fda.program</code> when filing. <code>null</code> when the program depends on the product's use</li>\n</ul>\n<h3 id=\"product-statement-values\">Product Statement Values</h3>\n<p>The statements that can appear in <code>disclaimersRequiredForShippingApproval</code> and <code>disclaimers</code>, and that items declare in <code>pgaDataset.statements</code>:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Statement</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>NotForMedicalUse</code></td>\n<td>The product is not intended for medical use</td>\n</tr>\n<tr>\n<td><code>ForExternalUseOnly</code></td>\n<td>The product is for external use only</td>\n</tr>\n<tr>\n<td><code>NotFood</code></td>\n<td>The product is not a food</td>\n</tr>\n<tr>\n<td><code>NotForFoodContact</code></td>\n<td>The product does not come into contact with food</td>\n</tr>\n<tr>\n<td><code>NotACosmetic</code></td>\n<td>The product is not a cosmetic</td>\n</tr>\n<tr>\n<td><code>NotAChildrensProduct</code></td>\n<td>The product is not designed or intended primarily for children 12 years old or younger</td>\n</tr>\n<tr>\n<td><code>NotAphisRegulated</code></td>\n<td>The product is not subject to APHIS plant or animal health regulation</td>\n</tr>\n<tr>\n<td><code>ContainsNoPlantMaterial</code></td>\n<td>The product contains no plant material</td>\n</tr>\n<tr>\n<td><code>PlantMaterialDeMinimis</code></td>\n<td>The product's plant material content is de minimis</td>\n</tr>\n<tr>\n<td><code>ContainsNoFishOrWildlife</code></td>\n<td>The product contains no fish or wildlife</td>\n</tr>\n</tbody>\n</table>\n</div><p>Statements for indicators of other agencies, accepted in <code>pgaDataset.statements</code> and named in rejection messages:</p>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Statement</th>\n<th>Meaning</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>NotOrganic</code></td>\n<td>The product is not marketed as organic (USDA AMS)</td>\n</tr>\n<tr>\n<td><code>NotAPesticide</code></td>\n<td>The product is not a pesticide (EPA)</td>\n</tr>\n<tr>\n<td><code>ContainsNoHydrofluorocarbons</code></td>\n<td>The product contains no hydrofluorocarbons (EPA)</td>\n</tr>\n<tr>\n<td><code>ContainsNoOzoneDepletingSubstances</code></td>\n<td>The product contains no ozone-depleting substances (EPA)</td>\n</tr>\n<tr>\n<td><code>NotAVehicleOrEngine</code></td>\n<td>The product is not a vehicle or engine (EPA)</td>\n</tr>\n<tr>\n<td><code>NotTtbRegulated</code></td>\n<td>The product is not an alcohol or tobacco product regulated by TTB</td>\n</tr>\n<tr>\n<td><code>NotAControlledSubstance</code></td>\n<td>The product is not a controlled substance (DEA)</td>\n</tr>\n<tr>\n<td><code>NotARegulatedMachine</code></td>\n<td>The product is not a regulated tableting or encapsulating machine (DEA)</td>\n</tr>\n<tr>\n<td><code>NotFsisRegulated</code></td>\n<td>The product is not a meat, poultry or egg product regulated by FSIS</td>\n</tr>\n<tr>\n<td><code>NotACoveredFishSpecies</code></td>\n<td>The product is not a fish species covered by NOAA Fisheries</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"notes\">Notes</h2>\n<ul>\n<li><code>otherAgencies</code> summarises the indicators of agencies without a filing section. They are checked when packages are submitted: a missing statement is rejected with <code>V_PgaRequiredInformationMissing</code> naming the indicator (e.g. <code>AM7 requires the statements NotOrganic</code>), and any code in <code>unsupportedIndicatorCodes</code> with <code>V_PgaProgramNotSupported</code></li>\n<li>PGA data becomes required on January 20, 2027 (see the collection introduction); until then the requirements are informational unless the PGA requirement already applies to your account</li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<ul>\n<li><strong>400 Bad Request</strong>: <code>V_InvalidHtsCode</code> (malformed <code>htsCode</code>) or <code>V_InvalidCountryCode</code> (invalid <code>countryOfOrigin</code>). Body <code>{ \"errors\": [{ \"fieldName\", \"rejectedValue\", \"code\", \"message\" }] }</code></li>\n<li><strong>404 Not Found</strong>: <code>RM_HtsCodeNotFound</code> (the code is not in the tariff schedule) or <code>RM_CountryNotFound</code>. Body <code>{ \"errors\": [{ \"code\", \"message\", \"referenceValue\", \"itemIndex\" }] }</code></li>\n</ul>\n","urlObject":{"path":["api","v1","hts","6101.30.15.00","requirements"],"host":["https://dutycollection.safepackage.com"],"query":[{"disabled":true,"description":{"content":"<p>Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it</p>\n","type":"text/plain"},"key":"countryOfOrigin","value":"CN"}],"variable":[]}},"response":[{"id":"b47d8cb2-d6ae-4e21-b920-78abaa99a571","name":"No PGA requirements (apparel)","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/6101.30.15.00/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","6101.30.15.00","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"6101.30.15.00\",\n  \"description\": \"Men's or boys' overcoats, carcoats, capes, cloaks, anoraks (including ski-jackets), windbreakers and similar articles, knitted or crocheted, other than those of heading 6103: Of man-made fibers: Containing 23 percent or more by weight of wool or fine animal hair (434)\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": true,\n    \"requiredQuantityUnits\": [\n      \"Kg\"\n    ],\n    \"acceptedQuantityUnits\": [\n      \"Dozen\",\n      \"Kg\"\n    ],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"Approved\",\n    \"disclaimersRequiredForShippingApproval\": null,\n    \"subjectToAntidumpingDuty\": false,\n    \"subjectToCountervailingDuty\": false\n  },\n  \"pga\": null\n}"},{"id":"0f09719f-4b4a-4623-a6ed-7e15239dcedc","name":"Quantity units for a country of origin","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/6101.30.15.00/requirements?countryOfOrigin=CN","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","6101.30.15.00","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"6101.30.15.00\",\n  \"description\": \"Men's or boys' overcoats, carcoats, capes, cloaks, anoraks (including ski-jackets), windbreakers and similar articles, knitted or crocheted, other than those of heading 6103: Of man-made fibers: Containing 23 percent or more by weight of wool or fine animal hair (434)\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": true,\n    \"requiredQuantityUnits\": [\n      \"Kg\"\n    ],\n    \"acceptedQuantityUnits\": [\n      \"Dozen\",\n      \"Kg\"\n    ],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"Approved\",\n    \"disclaimersRequiredForShippingApproval\": null,\n    \"subjectToAntidumpingDuty\": false,\n    \"subjectToCountervailingDuty\": false\n  },\n  \"pga\": null\n}"},{"id":"2eef9e47-0125-4858-a9fb-998685fd12f0","name":"Conditionally approved: not for medical use, FDA disclaimable","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/3924.10.40.00/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","3924.10.40.00","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"3924.10.40.00\",\n  \"description\": \"Tableware, kitchenware, other household articles and hygienic or toilet articles, of plastics: Tableware and kitchenware: Other\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": false,\n    \"requiredQuantityUnits\": [],\n    \"acceptedQuantityUnits\": [],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"ConditionallyApproved\",\n    \"disclaimersRequiredForShippingApproval\": [\n      \"NotForMedicalUse\"\n    ],\n    \"subjectToAntidumpingDuty\": false,\n    \"subjectToCountervailingDuty\": false\n  },\n  \"pga\": {\n    \"fda\": {\n      \"requirement\": \"Conditional\",\n      \"program\": null,\n      \"disclaimers\": [\n        [\n          \"NotForFoodContact\"\n        ]\n      ]\n    },\n    \"cpsc\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"laceyAct\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"aphisCore\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"tsca\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"fishAndWildlife\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"otherAgencies\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"unsupportedIndicatorCodes\": []\n  }\n}"},{"id":"8edd1171-7cd2-47b2-9b98-82704ca47cd0","name":"Mandatory FDA Cosmetics filing","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/3304.10.00.00/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","3304.10.00.00","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"3304.10.00.00\",\n  \"description\": \"Beauty or make-up preparations and preparations for the care of the skin (other than medicaments), including sunscreen or sun tan preparations; manicure or pedicure preparations: Lip make-up preparations\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": false,\n    \"requiredQuantityUnits\": [],\n    \"acceptedQuantityUnits\": [\n      \"Kg\"\n    ],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"Approved\",\n    \"disclaimersRequiredForShippingApproval\": null,\n    \"subjectToAntidumpingDuty\": false,\n    \"subjectToCountervailingDuty\": false\n  },\n  \"pga\": {\n    \"fda\": {\n      \"requirement\": \"Required\",\n      \"program\": \"Cosmetics\",\n      \"disclaimers\": null\n    },\n    \"cpsc\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"laceyAct\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"aphisCore\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"tsca\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"fishAndWildlife\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"otherAgencies\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"unsupportedIndicatorCodes\": []\n  }\n}"},{"id":"37bb982e-0b31-4d5f-83cb-b849654995c9","name":"Several agencies: FDA statements and Lacey Act alternatives","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/3301.29.51.50/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","3301.29.51.50","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"3301.29.51.50\",\n  \"description\": \"Essential oils (terpeneless or not), including concretes and absolutes; resinoids; extracted oleoresins; concentrates of essential oils in fats, in fixed oils, in waxes or the like, obtained by enfleurage or maceration; terpenic by products of the deterpenation of essential oils; aqueous distillates and aqueous solutions of essential oils: Other: Other Other\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": false,\n    \"requiredQuantityUnits\": [],\n    \"acceptedQuantityUnits\": [],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"ConditionallyApproved\",\n    \"disclaimersRequiredForShippingApproval\": [\n      \"NotForMedicalUse\"\n    ],\n    \"subjectToAntidumpingDuty\": false,\n    \"subjectToCountervailingDuty\": false\n  },\n  \"pga\": {\n    \"fda\": {\n      \"requirement\": \"Conditional\",\n      \"program\": null,\n      \"disclaimers\": [\n        [\n          \"NotForMedicalUse\",\n          \"NotFood\"\n        ]\n      ]\n    },\n    \"cpsc\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"laceyAct\": {\n      \"requirement\": \"Conditional\",\n      \"disclaimers\": [\n        [\n          \"ContainsNoPlantMaterial\"\n        ],\n        [\n          \"PlantMaterialDeMinimis\"\n        ]\n      ]\n    },\n    \"aphisCore\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"tsca\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"fishAndWildlife\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"otherAgencies\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"unsupportedIndicatorCodes\": []\n  }\n}"},{"id":"568a226c-d62d-4d66-a7f9-3e1f9947221e","name":"Conditionally approved: not food, food contact decides FDA","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/6911.90.00.10/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","6911.90.00.10","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"6911.90.00.10\",\n  \"description\": \"Tableware, kitchenware, other household articles and toilet articles, of porcelain or china: Other Toilet articles\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": false,\n    \"requiredQuantityUnits\": [],\n    \"acceptedQuantityUnits\": [],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"ConditionallyApproved\",\n    \"disclaimersRequiredForShippingApproval\": [\n      \"NotFood\"\n    ],\n    \"subjectToAntidumpingDuty\": false,\n    \"subjectToCountervailingDuty\": false\n  },\n  \"pga\": {\n    \"fda\": {\n      \"requirement\": \"Conditional\",\n      \"program\": null,\n      \"disclaimers\": [\n        [\n          \"NotForFoodContact\"\n        ]\n      ]\n    },\n    \"cpsc\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"laceyAct\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"aphisCore\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"tsca\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"fishAndWildlife\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"otherAgencies\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"unsupportedIndicatorCodes\": []\n  }\n}"},{"id":"6e19b41a-a0e5-484c-9c20-ecd9157cc82e","name":"Not approved: antidumping and countervailing duty cases","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/3923.10.90.00/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","3923.10.90.00","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"htsCode\": \"3923.10.90.00\",\n  \"description\": \"Articles for the conveyance or packing of goods, of plastics; stoppers, lids, caps and other closures, of plastics: Boxes, cases, crates and similar articles: Other\",\n  \"dutyCalculation\": {\n    \"requiresSpecificQuantityUnit\": false,\n    \"requiredQuantityUnits\": [],\n    \"acceptedQuantityUnits\": [\n      \"Kg\"\n    ],\n    \"requiredComponents\": []\n  },\n  \"shipmentApproval\": {\n    \"approvedForShipping\": \"NotApproved\",\n    \"disclaimersRequiredForShippingApproval\": null,\n    \"subjectToAntidumpingDuty\": true,\n    \"subjectToCountervailingDuty\": true\n  },\n  \"pga\": {\n    \"fda\": {\n      \"requirement\": \"Conditional\",\n      \"program\": null,\n      \"disclaimers\": [\n        [\n          \"NotForFoodContact\"\n        ]\n      ]\n    },\n    \"cpsc\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"laceyAct\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"aphisCore\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"tsca\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"fishAndWildlife\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"otherAgencies\": {\n      \"requirement\": \"NotRequired\",\n      \"disclaimers\": null\n    },\n    \"unsupportedIndicatorCodes\": []\n  }\n}"},{"id":"def9fd44-c26d-4e73-8938-ff7f9606fe21","name":"Invalid HTS code","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/61AB/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","61AB","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"HtsCode\",\n      \"rejectedValue\": \"61AB\",\n      \"code\": \"V_InvalidHtsCode\",\n      \"message\": \"Invalid HTS code. The HTS code must have 10 digits\"\n    }\n  ]\n}"},{"id":"a7dd413d-7055-4c4f-b03d-2b7cdf98bec1","name":"HTS code not in the tariff schedule","originalRequest":{"method":"GET","header":[{"key":"Authorization","value":"Bearer "}],"url":{"raw":"https://dutycollection.safepackage.com/api/v1/hts/6101.30.99.99/requirements","host":["https://dutycollection.safepackage.com"],"path":["api","v1","hts","6101.30.99.99","requirements"],"query":[{"key":"countryOfOrigin","value":"CN","description":"Optional ISO 3166-1 alpha-2 country of origin; limits requiredQuantityUnits to the rate that applies to it","disabled":true}]}},"status":"Not Found","code":404,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"code\": \"RM_HtsCodeNotFound\",\n      \"message\": \"The HTS code does not resolve to a tariff schedule entry\",\n      \"referenceValue\": \"6101309999\",\n      \"itemIndex\": null\n    }\n  ]\n}"}],"_postman_id":"30e0c89e-0b92-4043-be33-2106454cfb61"}],"id":"84afa637-26f9-4db6-8ae6-6fcbf403ce4f","description":"<p>Query the tariff schedule for what an item under a given HTS code must carry at submission.</p>\n","_postman_id":"84afa637-26f9-4db6-8ae6-6fcbf403ce4f"},{"name":"Shipments","item":[{"name":"Create Shipment (Complete Workflow)","id":"70390fc9-13e6-4e3b-8ec0-946382e05308","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"inputCurrency\": \"USD\",\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                {\n                    \"trackingReference\": \"US123456789US\",\n                    \"sender\": {\n                        \"fullName\": \"John Doe\",\n                        \"email\": \"john.doe@example.com\"\n                    },\n                    \"items\": [\n                        {\n                            \"images\": [\n                                {\n                                    \"reference\": \"IMG-0001\",\n                                    \"base64Content\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=\"\n                                }\n                            ],\n                            \"countryOfOrigin\": \"CN\",\n                            \"description\": \"Men's knitted cotton t-shirt, short sleeve\",\n                            \"htsCode\": \"6109.10.00.12\",\n                            \"quantity\": 3,\n                            \"totalDeclaredValue\": 77.97,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 0.6,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ]\n                        },\n                        {\n                            \"manufacturer\": {\n                                \"businessName\": \"Example Ceramics Co.\",\n                                \"address\": {\n                                    \"countryIso2Code\": \"JP\"\n                                }\n                            },\n                            \"description\": \"Ceramic coffee mug, hand painted\",\n                            \"htsCode\": \"6912.00.44.00\",\n                            \"quantity\": 2,\n                            \"singleUnitDeclaredValue\": 45.5,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 1.4,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ],\n                            \"pgaDataset\": {\n                                \"statements\": [\n                                    \"NotForMedicalUse\"\n                                ],\n                                \"fda\": {\n                                    \"program\": \"FoodContact\",\n                                    \"intendedUseCode\": \"FoodAdditiveOrFoodContactSubstance\",\n                                    \"productCode\": \"23FGH07\",\n                                    \"countryOfProductionIso2Code\": \"JP\",\n                                    \"tradeBrandName\": \"Example Brand\",\n                                    \"productSpecificDescription\": \"Hand painted ceramic coffee mug, 350 ml\",\n                                    \"packagingLevels\": [\n                                        {\n                                            \"quantity\": 1,\n                                            \"unitCode\": \"BX\"\n                                        },\n                                        {\n                                            \"quantity\": 2,\n                                            \"unitCode\": \"PCS\"\n                                        }\n                                    ]\n                                }\n                            }\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                {\n                    \"trackingReference\": \"CN987654321CN\",\n                    \"items\": [\n                        {\n                            \"countryOfOrigin\": \"DE\",\n                            \"description\": \"Leather wallet, bovine\",\n                            \"htsCode\": \"4202.31.60.00\",\n                            \"quantity\": 1,\n                            \"totalDeclaredValue\": 75.0,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 0.2,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ]\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/shipments","description":"<h1 id=\"create-shipment-complete-workflow\">Create Shipment (Complete Workflow)</h1>\n<p>Creates packages and their containers in a single request: the packages are created (or updated, when one of your packages already has the tracking reference), assigned to the shipment of their container's entry route, and their duties are calculated.</p>\n<h2 id=\"request-body-fields\">Request Body Fields</h2>\n<h3 id=\"root-object\">Root Object</h3>\n<ul>\n<li><strong>containers</strong> (array, required): Containers of the shipment (min 1)<ul>\n<li>Container tracking references must be unique within the request, and package tracking references unique across the whole request (<code>V_DuplicateValuesNotAllowed</code>)</li>\n<li>At most 1000 items in total across all packages (<code>V_MaxItemCountExceeded</code>)</li>\n</ul>\n</li>\n<li><strong>inputCurrency</strong> (string, optional): ISO 4217 code of the currency the declared values are in. Defaults to <code>USD</code></li>\n<li><strong>dataProviderCode</strong> (string, optional): Code of the data provider the packages are submitted through, when one has been agreed with your account</li>\n</ul>\n<h3 id=\"container-object\">Container Object</h3>\n<ul>\n<li><strong>trackingReference</strong> (string, required): Your identifier for the container, max 50 characters</li>\n<li><strong>entryRoute</strong> (object, required): How and when the container arrives (see below)</li>\n<li><strong>packages</strong> (array, required): The container's packages (min 1). Same fields as the package object of <strong>Create Packages</strong>, except that <strong>trackingReference</strong> is required here</li>\n</ul>\n<h3 id=\"entry-route-object\">Entry Route Object</h3>\n<ul>\n<li><strong>flightOrTripNumber</strong> (string, required): Transport identifier, letters and digits only (<code>V_InvalidFlightOrTripNumber</code>)<ul>\n<li>Air: flight number (e.g. <code>AA1234</code>, <code>DL53</code>)</li>\n<li>Sea: voyage number; Land: trip or route number</li>\n</ul>\n</li>\n<li><strong>transportType</strong> (string, required): <code>Air</code>, <code>Land</code> or <code>Sea</code></li>\n<li><strong>carrierCode</strong> (string, required): 2-character IATA airline code (uppercase letters or digits, e.g. <code>AA</code>, <code>DL</code>) or 4-letter SCAC code (uppercase, e.g. <code>MAEU</code>) (<code>V_InvalidCarrierCode</code>)</li>\n<li><strong>arrivalPortCode</strong> (string, required): 4-digit CBP port of entry code, e.g. <code>4701</code> (<code>V_InvalidCustomsPortCode</code>)</li>\n<li><strong>entryDate</strong> (string, conditional): Arrival date, <code>YYYY-MM-DD</code></li>\n<li><strong>entryTimestamp</strong> (string, conditional): Arrival date and time, ISO 8601 (e.g. <code>2026-11-16T10:30:00Z</code>)<ul>\n<li>One of <code>entryDate</code> or <code>entryTimestamp</code> is required (<code>V_ValueEmpty</code>); <code>entryTimestamp</code> wins when both are sent</li>\n</ul>\n</li>\n<li>Containers with the same entry route are assigned to the same shipment. Packages and shipments with an entry date in the previous month can still be submitted or changed until the 3rd of the current month (UTC); after that, and for any earlier month, they are rejected with <code>APP_CannotChangeShipmentForPackageFromPreviousMonth</code> or <code>APP_CannotModifyPackageFromPreviousMonth</code></li>\n</ul>\n<h3 id=\"package-and-item-objects\">Package and Item Objects</h3>\n<p>Packages and items take exactly the fields documented on <strong>Create Packages</strong>:</p>\n<ul>\n<li>package: <code>trackingReference</code> (required here), <code>classificationType</code>, <code>sender</code>, <code>consignee</code>, <code>items</code></li>\n<li>item: <code>description</code>, <code>countryOfOrigin</code> / <code>manufacturer</code> (the manufacturer's address country is the country of origin when given; both must agree when both are sent, <code>V_CountryOfOriginMismatch</code>), one of <code>totalDeclaredValue</code> / <code>singleUnitDeclaredValue</code> / <code>declaredValue</code>, <code>htsCode</code>, <code>quantity</code>, <code>customsQuantities</code>, <code>externalReference</code>, <code>components</code>, <code>provenance</code>, <code>images</code> and <code>pgaDataset</code></li>\n</ul>\n<p><strong>PGA / Entry Type 13 data</strong> (<code>pgaDataset</code>) is documented on <strong>Create Packages</strong>. It is optional until January 20, 2027 and then required depending on the item's HTS code; use <strong>Get HTS Code Requirements</strong> to see what a code needs.</p>\n<h2 id=\"response\">Response</h2>\n<p><code>200 OK</code> when everything was saved, <code>207 Multi-Status</code> when at least one package or container failed (the rest is saved).</p>\n<ul>\n<li><strong>packageResult</strong><ul>\n<li><strong>packages</strong> (array): the saved packages: <strong>id</strong>, <strong>trackingReference</strong>, <strong>sender</strong> (<code>fullName</code>, <code>email</code>), <strong>shipment</strong>, <strong>totalDeclaredValue</strong>, <strong>totalDutiesOwed</strong>, <strong>fee</strong> (USD), <strong>createdAtUtc</strong> and <strong>items</strong> (<strong>id</strong>, <strong>declaredValue</strong> (per unit), <strong>countryOfOrigin</strong>, <strong>tariffRatePercentage</strong>, <strong>dutiesOwed</strong> (whole line), <strong>htsCode</strong>)</li>\n<li><strong>packageErrors</strong> (array): <strong>code</strong>, <strong>message</strong>, <strong>referenceValue</strong></li>\n</ul>\n</li>\n<li><strong>containersResult</strong><ul>\n<li><strong>containers</strong> (array): <strong>trackingReference</strong>, <strong>shipment</strong> and the container's <strong>packages</strong> (same fields as above, items without <code>htsCode</code>)</li>\n<li><strong>containerErrors</strong> (array): <strong>code</strong>, <strong>message</strong>, <strong>referenceValue</strong></li>\n</ul>\n</li>\n<li><strong>shipment</strong> objects carry <strong>id</strong>, <strong>flightOrTripNumber</strong>, <strong>transportType</strong>, <strong>carrierCode</strong>, <strong>arrivalPortCode</strong> and <strong>entryTimestamp</strong></li>\n</ul>\n<h2 id=\"errors\">Errors</h2>\n<h3 id=\"400-bad-request\">400 Bad Request</h3>\n<p>Invalid request; nothing is saved. Body <code>{ \"errors\": [{ \"fieldName\", \"rejectedValue\", \"code\", \"message\" }] }</code>; <code>fieldName</code> is the path in the request, e.g. <code>Containers[0].Packages[1].Items[0].CountryOfOrigin</code>. The codes are those of <strong>Create Packages</strong> and <strong>Create Containers</strong>.</p>\n<h3 id=\"207-multi-status\">207 Multi-Status</h3>\n<p>Codes in <code>packageErrors</code> / <code>containerErrors</code> include the per-package codes of <strong>Create Packages</strong> (e.g. <code>APP_HtsClassificationFailed</code>, <code>V_PackageDeclaredValueExceedsAllowedLimit</code>, <code>D_PackageReferenceAlreadyInUse</code>, <code>D_CannotEditContentOfPaidPackage</code>, the PGA codes) and of <strong>Create Containers</strong> (e.g. <code>V_InvalidCustomsPortCode</code>, <code>D_CannotAssignToShipmentWithoutCompletedPayment</code>, <code>APP_CannotChangeShipmentForPackageFromPreviousMonth</code>).</p>\n<h3 id=\"404-not-found\">404 Not Found</h3>\n<p><code>RM_ClientNotFound</code> when the authenticated account is not known, or <code>D_DataProviderNotAllowedForShipper</code> when the <code>dataProviderCode</code> is not enabled for your account.</p>\n<h3 id=\"409-conflict\">409 Conflict</h3>\n<p>The request cannot be processed as a whole, e.g. no conversion rate is available for <code>inputCurrency</code>.</p>\n<h2 id=\"business-rules\">Business Rules</h2>\n<ul>\n<li>Package tracking references must be unique system-wide; container references unique within the request</li>\n<li>Each container needs at least one package and each package at least one item</li>\n<li>Declared values must be greater than zero, except on return items; country codes must be valid ISO 3166-1 alpha-2 codes</li>\n<li>Duties are calculated per item from HTS code, country of origin, declared value and quantities, for the entry date of the container</li>\n</ul>\n","urlObject":{"path":["api","v1","shipments"],"host":["https://dutycollection.safepackage.com"],"query":[],"variable":[]}},"response":[{"id":"73460e24-2e7d-4d93-bb01-d50fc6121b0d","name":"Successful Shipment Creation","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"inputCurrency\": \"USD\",\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                {\n                    \"trackingReference\": \"US123456789US\",\n                    \"sender\": {\n                        \"fullName\": \"John Doe\",\n                        \"email\": \"john.doe@example.com\"\n                    },\n                    \"items\": [\n                        {\n                            \"images\": [\n                                {\n                                    \"reference\": \"IMG-0001\",\n                                    \"base64Content\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=\"\n                                }\n                            ],\n                            \"countryOfOrigin\": \"CN\",\n                            \"description\": \"Men's knitted cotton t-shirt, short sleeve\",\n                            \"htsCode\": \"6109.10.00.12\",\n                            \"quantity\": 3,\n                            \"totalDeclaredValue\": 77.97,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 0.6,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ]\n                        },\n                        {\n                            \"manufacturer\": {\n                                \"businessName\": \"Example Ceramics Co.\",\n                                \"address\": {\n                                    \"countryIso2Code\": \"JP\"\n                                }\n                            },\n                            \"description\": \"Ceramic coffee mug, hand painted\",\n                            \"htsCode\": \"6912.00.44.00\",\n                            \"quantity\": 2,\n                            \"singleUnitDeclaredValue\": 45.5,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 1.4,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ],\n                            \"pgaDataset\": {\n                                \"statements\": [\n                                    \"NotForMedicalUse\"\n                                ],\n                                \"fda\": {\n                                    \"program\": \"FoodContact\",\n                                    \"intendedUseCode\": \"FoodAdditiveOrFoodContactSubstance\",\n                                    \"productCode\": \"23FGH07\",\n                                    \"countryOfProductionIso2Code\": \"JP\",\n                                    \"tradeBrandName\": \"Example Brand\",\n                                    \"productSpecificDescription\": \"Hand painted ceramic coffee mug, 350 ml\",\n                                    \"packagingLevels\": [\n                                        {\n                                            \"quantity\": 1,\n                                            \"unitCode\": \"BX\"\n                                        },\n                                        {\n                                            \"quantity\": 2,\n                                            \"unitCode\": \"PCS\"\n                                        }\n                                    ]\n                                }\n                            }\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                {\n                    \"trackingReference\": \"CN987654321CN\",\n                    \"items\": [\n                        {\n                            \"countryOfOrigin\": \"DE\",\n                            \"description\": \"Leather wallet, bovine\",\n                            \"htsCode\": \"4202.31.60.00\",\n                            \"quantity\": 1,\n                            \"totalDeclaredValue\": 75.0,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 0.2,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ]\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/shipments"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"packageResult\": {\n    \"packages\": [\n      {\n        \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\",\n        \"trackingReference\": \"US123456789US\",\n        \"sender\": {\n          \"fullName\": \"John Doe\",\n          \"email\": \"john.doe@example.com\"\n        },\n        \"shipment\": {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n          \"flightOrTripNumber\": \"AA1234\",\n          \"transportType\": \"Air\",\n          \"carrierCode\": \"AA\",\n          \"arrivalPortCode\": \"4701\",\n          \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n        },\n        \"totalDeclaredValue\": 168.97,\n        \"totalDutiesOwed\": 21.97,\n        \"fee\": 2.5,\n        \"items\": [\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c111\",\n            \"declaredValue\": 25.99,\n            \"countryOfOrigin\": \"CN\",\n            \"tariffRatePercentage\": 16.5,\n            \"dutiesOwed\": 12.87,\n            \"htsCode\": \"6109100012\"\n          },\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c112\",\n            \"declaredValue\": 45.5,\n            \"countryOfOrigin\": \"JP\",\n            \"tariffRatePercentage\": 10.0,\n            \"dutiesOwed\": 9.1,\n            \"htsCode\": \"6912004400\"\n          }\n        ],\n        \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\"\n      },\n      {\n        \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c102\",\n        \"trackingReference\": \"CN987654321CN\",\n        \"sender\": null,\n        \"shipment\": {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d102\",\n          \"flightOrTripNumber\": \"DL53\",\n          \"transportType\": \"Air\",\n          \"carrierCode\": \"DL\",\n          \"arrivalPortCode\": \"4701\",\n          \"entryTimestamp\": \"2026-11-17T00:00:00\"\n        },\n        \"totalDeclaredValue\": 75.0,\n        \"totalDutiesOwed\": 6.0,\n        \"fee\": 2.5,\n        \"items\": [\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c121\",\n            \"declaredValue\": 75.0,\n            \"countryOfOrigin\": \"DE\",\n            \"tariffRatePercentage\": 8.0,\n            \"dutiesOwed\": 6.0,\n            \"htsCode\": \"4202316000\"\n          }\n        ],\n        \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\"\n      }\n    ],\n    \"packageErrors\": []\n  },\n  \"containersResult\": {\n    \"containers\": [\n      {\n        \"trackingReference\": \"CONT001-AA1234\",\n        \"shipment\": {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n          \"flightOrTripNumber\": \"AA1234\",\n          \"transportType\": \"Air\",\n          \"carrierCode\": \"AA\",\n          \"arrivalPortCode\": \"4701\",\n          \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n        },\n        \"packages\": [\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\",\n            \"trackingReference\": \"US123456789US\",\n            \"sender\": {\n              \"fullName\": \"John Doe\",\n              \"email\": \"john.doe@example.com\"\n            },\n            \"shipment\": {\n              \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n              \"flightOrTripNumber\": \"AA1234\",\n              \"transportType\": \"Air\",\n              \"carrierCode\": \"AA\",\n              \"arrivalPortCode\": \"4701\",\n              \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"totalDeclaredValue\": 168.97,\n            \"totalDutiesOwed\": 21.97,\n            \"fee\": 2.5,\n            \"items\": [\n              {\n                \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c111\",\n                \"declaredValue\": 25.99,\n                \"countryOfOrigin\": \"CN\",\n                \"tariffRatePercentage\": 16.5,\n                \"dutiesOwed\": 12.87\n              },\n              {\n                \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c112\",\n                \"declaredValue\": 45.5,\n                \"countryOfOrigin\": \"JP\",\n                \"tariffRatePercentage\": 10.0,\n                \"dutiesOwed\": 9.1\n              }\n            ],\n            \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\"\n          }\n        ]\n      },\n      {\n        \"trackingReference\": \"CONT002-DL53\",\n        \"shipment\": {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d102\",\n          \"flightOrTripNumber\": \"DL53\",\n          \"transportType\": \"Air\",\n          \"carrierCode\": \"DL\",\n          \"arrivalPortCode\": \"4701\",\n          \"entryTimestamp\": \"2026-11-17T00:00:00\"\n        },\n        \"packages\": [\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c102\",\n            \"trackingReference\": \"CN987654321CN\",\n            \"sender\": null,\n            \"shipment\": {\n              \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d102\",\n              \"flightOrTripNumber\": \"DL53\",\n              \"transportType\": \"Air\",\n              \"carrierCode\": \"DL\",\n              \"arrivalPortCode\": \"4701\",\n              \"entryTimestamp\": \"2026-11-17T00:00:00\"\n            },\n            \"totalDeclaredValue\": 75.0,\n            \"totalDutiesOwed\": 6.0,\n            \"fee\": 2.5,\n            \"items\": [\n              {\n                \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c121\",\n                \"declaredValue\": 75.0,\n                \"countryOfOrigin\": \"DE\",\n                \"tariffRatePercentage\": 8.0,\n                \"dutiesOwed\": 6.0\n              }\n            ],\n            \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\"\n          }\n        ]\n      }\n    ],\n    \"containerErrors\": []\n  }\n}"},{"id":"902c0959-cb16-4f32-8a06-f3802074e78d","name":"Partial Success with Errors","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"inputCurrency\": \"USD\",\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"packages\": [\n                {\n                    \"trackingReference\": \"US123456789US\",\n                    \"sender\": {\n                        \"fullName\": \"John Doe\",\n                        \"email\": \"john.doe@example.com\"\n                    },\n                    \"items\": [\n                        {\n                            \"images\": [\n                                {\n                                    \"reference\": \"IMG-0001\",\n                                    \"base64Content\": \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=\"\n                                }\n                            ],\n                            \"countryOfOrigin\": \"CN\",\n                            \"description\": \"Men's knitted cotton t-shirt, short sleeve\",\n                            \"htsCode\": \"6109.10.00.12\",\n                            \"quantity\": 3,\n                            \"totalDeclaredValue\": 77.97,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 0.6,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ]\n                        },\n                        {\n                            \"manufacturer\": {\n                                \"businessName\": \"Example Ceramics Co.\",\n                                \"address\": {\n                                    \"countryIso2Code\": \"JP\"\n                                }\n                            },\n                            \"description\": \"Ceramic coffee mug, hand painted\",\n                            \"htsCode\": \"6912.00.44.00\",\n                            \"quantity\": 2,\n                            \"singleUnitDeclaredValue\": 45.5,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 1.4,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ],\n                            \"pgaDataset\": {\n                                \"statements\": [\n                                    \"NotForMedicalUse\"\n                                ],\n                                \"fda\": {\n                                    \"program\": \"FoodContact\",\n                                    \"intendedUseCode\": \"FoodAdditiveOrFoodContactSubstance\",\n                                    \"productCode\": \"23FGH07\",\n                                    \"countryOfProductionIso2Code\": \"JP\",\n                                    \"tradeBrandName\": \"Example Brand\",\n                                    \"productSpecificDescription\": \"Hand painted ceramic coffee mug, 350 ml\",\n                                    \"packagingLevels\": [\n                                        {\n                                            \"quantity\": 1,\n                                            \"unitCode\": \"BX\"\n                                        },\n                                        {\n                                            \"quantity\": 2,\n                                            \"unitCode\": \"PCS\"\n                                        }\n                                    ]\n                                }\n                            }\n                        }\n                    ]\n                }\n            ]\n        },\n        {\n            \"trackingReference\": \"CONT002-DL53\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"DL53\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"DL\",\n                \"arrivalPortCode\": \"4701\",\n                \"entryDate\": \"2026-11-17\"\n            },\n            \"packages\": [\n                {\n                    \"trackingReference\": \"CN987654321CN\",\n                    \"items\": [\n                        {\n                            \"countryOfOrigin\": \"DE\",\n                            \"description\": \"Leather wallet, bovine\",\n                            \"htsCode\": \"4202.31.60.00\",\n                            \"quantity\": 1,\n                            \"totalDeclaredValue\": 75.0,\n                            \"customsQuantities\": [\n                                {\n                                    \"value\": 0.2,\n                                    \"unitOfMeasure\": \"Kg\"\n                                }\n                            ]\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/shipments"},"status":"Multi-Status","code":207,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"packageResult\": {\n    \"packages\": [\n      {\n        \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\",\n        \"trackingReference\": \"US123456789US\",\n        \"sender\": {\n          \"fullName\": \"John Doe\",\n          \"email\": \"john.doe@example.com\"\n        },\n        \"shipment\": {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n          \"flightOrTripNumber\": \"AA1234\",\n          \"transportType\": \"Air\",\n          \"carrierCode\": \"AA\",\n          \"arrivalPortCode\": \"4701\",\n          \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n        },\n        \"totalDeclaredValue\": 168.97,\n        \"totalDutiesOwed\": 21.97,\n        \"fee\": 2.5,\n        \"items\": [\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c111\",\n            \"declaredValue\": 25.99,\n            \"countryOfOrigin\": \"CN\",\n            \"tariffRatePercentage\": 16.5,\n            \"dutiesOwed\": 12.87,\n            \"htsCode\": \"6109100012\"\n          },\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c112\",\n            \"declaredValue\": 45.5,\n            \"countryOfOrigin\": \"JP\",\n            \"tariffRatePercentage\": 10.0,\n            \"dutiesOwed\": 9.1,\n            \"htsCode\": \"6912004400\"\n          }\n        ],\n        \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\"\n      }\n    ],\n    \"packageErrors\": [\n      {\n        \"code\": \"D_PackageReferenceAlreadyInUse\",\n        \"message\": \"Package reference is already in use for another package\",\n        \"referenceValue\": null\n      }\n    ]\n  },\n  \"containersResult\": {\n    \"containers\": [\n      {\n        \"trackingReference\": \"CONT001-AA1234\",\n        \"shipment\": {\n          \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n          \"flightOrTripNumber\": \"AA1234\",\n          \"transportType\": \"Air\",\n          \"carrierCode\": \"AA\",\n          \"arrivalPortCode\": \"4701\",\n          \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n        },\n        \"packages\": [\n          {\n            \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c101\",\n            \"trackingReference\": \"US123456789US\",\n            \"sender\": {\n              \"fullName\": \"John Doe\",\n              \"email\": \"john.doe@example.com\"\n            },\n            \"shipment\": {\n              \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0d101\",\n              \"flightOrTripNumber\": \"AA1234\",\n              \"transportType\": \"Air\",\n              \"carrierCode\": \"AA\",\n              \"arrivalPortCode\": \"4701\",\n              \"entryTimestamp\": \"2026-11-16T10:30:00Z\"\n            },\n            \"totalDeclaredValue\": 168.97,\n            \"totalDutiesOwed\": 21.97,\n            \"fee\": 2.5,\n            \"items\": [\n              {\n                \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c111\",\n                \"declaredValue\": 25.99,\n                \"countryOfOrigin\": \"CN\",\n                \"tariffRatePercentage\": 16.5,\n                \"dutiesOwed\": 12.87\n              },\n              {\n                \"id\": \"0198c5a0-7b3e-7f21-9c44-3d2a91b0c112\",\n                \"declaredValue\": 45.5,\n                \"countryOfOrigin\": \"JP\",\n                \"tariffRatePercentage\": 10.0,\n                \"dutiesOwed\": 9.1\n              }\n            ],\n            \"createdAtUtc\": \"2026-11-10T10:35:22.123Z\"\n          }\n        ]\n      }\n    ],\n    \"containerErrors\": []\n  }\n}"},{"id":"ce983878-a178-461f-a401-32e34e8224e4","name":"Validation Error","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Bearer "}],"body":{"mode":"raw","raw":"{\n    \"containers\": [\n        {\n            \"trackingReference\": \"CONT001-AA1234\",\n            \"entryRoute\": {\n                \"flightOrTripNumber\": \"AA1234\",\n                \"transportType\": \"Air\",\n                \"carrierCode\": \"AA\",\n                \"arrivalPortCode\": \"4701\"\n            },\n            \"packages\": [\n                {\n                    \"items\": [\n                        {\n                            \"countryOfOrigin\": \"XX\",\n                            \"description\": \"Cotton scarf\",\n                            \"totalDeclaredValue\": -5.0\n                        }\n                    ]\n                }\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://dutycollection.safepackage.com/api/v1/shipments"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"}],"cookie":[],"responseTime":null,"body":"{\n  \"errors\": [\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.EntryDate\",\n      \"rejectedValue\": null,\n      \"code\": \"V_ValueEmpty\",\n      \"message\": \"Value cannot be empty\"\n    },\n    {\n      \"fieldName\": \"Containers[0].EntryRoute.EntryTimestamp\",\n      \"rejectedValue\": null,\n      \"code\": \"V_ValueEmpty\",\n      \"message\": \"Value cannot be empty\"\n    },\n    {\n      \"fieldName\": \"Containers[0].Packages[0].Items[0].CountryOfOrigin\",\n      \"rejectedValue\": \"XX\",\n      \"code\": \"V_InvalidCountryCode\",\n      \"message\": \"Invalid ISO2 country code\"\n    },\n    {\n      \"fieldName\": \"Containers[0].Packages[0].Items[0].TotalDeclaredValue\",\n      \"rejectedValue\": \"-5.0\",\n      \"code\": \"V_ValueMustBeGreaterThanZero\",\n      \"message\": \"Value must be greater than zero\"\n    },\n    {\n      \"fieldName\": \"Containers[0].Packages\",\n      \"rejectedValue\": null,\n      \"code\": \"V_ValueEmpty\",\n      \"message\": \"Value cannot be empty\"\n    }\n  ]\n}"}],"_postman_id":"70390fc9-13e6-4e3b-8ec0-946382e05308"}],"id":"73e66df1-d30b-4fd5-9490-635fe4c7fb7b","description":"<p>Complete shipment processing combining packages, containers, and manifest generation in a single operation.</p>\n","_postman_id":"73e66df1-d30b-4fd5-9490-635fe4c7fb7b"}],"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["// International Mail Duty Collection API - Auto Token Management","// This script automatically handles JWT token refresh for seamless API testing","","const tokenUrl = pm.environment.get('token_url') || pm.globals.get('token_url');","const clientId = pm.environment.get('client_id') || pm.globals.get('client_id');","const clientSecret = pm.environment.get('client_secret') || pm.globals.get('client_secret');","","// Skip token refresh for development environment","const baseUrl = pm.environment.get('base_url') || pm.globals.get('base_url');","if (baseUrl && baseUrl.includes('localhost')) {","    console.log('Development environment detected - skipping authentication');","    return;","}","","// Check if we need to refresh the token","const currentToken = pm.environment.get('access_token') || pm.globals.get('access_token');","const tokenExpiry = pm.environment.get('token_expiry') || pm.globals.get('token_expiry');","","const now = new Date().getTime();","const expiryTime = tokenExpiry ? parseInt(tokenExpiry) : 0;","","// Refresh token if expired or not present","if (!currentToken || now >= expiryTime) {","    if (!tokenUrl || !clientId || !clientSecret) {","        console.warn('Token credentials not configured. Set token_url, client_id, and client_secret in environment variables.');","        return;","    }","    ","    console.log('Refreshing access token...');","    ","    pm.sendRequest({","        url: tokenUrl,","        method: 'POST',","        header: {","            'Content-Type': 'application/x-www-form-urlencoded'","        },","        body: {","            mode: 'urlencoded',","            urlencoded: [","                { key: 'grant_type', value: 'client_credentials' },","                { key: 'client_id', value: clientId },","                { key: 'client_secret', value: clientSecret }","            ]","        }","    }, (err, res) => {","        if (err) {","            console.error('Token refresh failed:', err);","            return;","        }","        ","        if (res.code === 200) {","            const responseJson = res.json();","            const newToken = responseJson.access_token;","            const expiresIn = responseJson.expires_in || 3600;","            const newExpiry = new Date().getTime() + (expiresIn * 1000) - 60000; // 1 min buffer","            ","            pm.environment.set('access_token', newToken);","            pm.environment.set('token_expiry', newExpiry.toString());","            ","            console.log('Token refreshed successfully');","        } else {","            console.error('Token refresh failed with status:', res.code);","            console.error('Response:', res.text());","        }","    });","} else {","    console.log('Token is still valid');","}"],"id":"ca99f66b-2a12-4077-9597-ba09bd4e2c1b"}},{"listen":"test","script":{"type":"text/javascript","packages":{},"exec":[""],"id":"f7c45f15-d91b-4c59-b468-3b994a443f0c"}}],"variable":[{"key":"base_url","value":"https://dutycollection.safepackage.com","description":"API Base URL - Production endpoint (sandbox: https://dutycollection-sandbox.safepackage.com)"},{"key":"token_url","value":"https://auth.dutycollection.safepackage.com/realms/SafePackage/protocol/openid-connect/token","description":"OAuth2 token endpoint - Production (sandbox: https://auth.dutycollection-sandbox.safepackage.com/realms/SafePackage/protocol/openid-connect/token)"},{"key":"client_id","value":"","description":"OAuth2 client ID for API access"},{"key":"client_secret","value":"","description":"OAuth2 client secret - Keep secure!"},{"key":"access_token","value":"","description":"JWT access token - Auto-managed by pre-request script"},{"key":"token_expiry","value":"","description":"Token expiry timestamp - Auto-managed"}]}