{"info":{"_postman_id":"ec7f2f6a-ed76-4918-8a58-1fcc1572f832","name":"MagicMatch by LiquiDonate - Donation as a Service","description":"<html><head></head><body><p>Welcome to the LiquiDonate API documentation! This API provides seamless integration for retailers to effortlessly match and ship items to nonprofits. Below, you'll find details on how to set up your retailer account and utilize the available endpoints.</p>\n<h3 id=\"setting-up-retailer-account\">Setting Up Retailer Account</h3>\n<p>Endpoint: <code>v1/setupRetailer</code></p>\n<p>To begin using the LiquiDonate API, the first step is to set up your retailer account. This endpoint enables you to register your retailer details and obtain the necessary API key and secret key for authentication.</p>\n<h3 id=\"available-endpoints\">Available Endpoints</h3>\n<h4 id=\"1-match-and-ship\">1. Match and Ship</h4>\n<p>Endpoint: <code>v1/matchAndShip</code></p>\n<p>This endpoint serves a dual purpose: it matches items to suitable nonprofits and automatically generates a shipping label for seamless delivery.</p>\n<h4 id=\"2-ship\">2. Ship</h4>\n<p>Endpoint: <code>v1/ship</code></p>\n<p>Use this endpoint when you only need to generate a shipping label. It facilitates the shipment of items from a preset location to a predetermined destination.</p>\n<h4 id=\"3-match\">3. Match</h4>\n<p>Endpoint: <code>v1/match</code></p>\n<p>When you solely need to match items to appropriate nonprofits without generating a shipping label, this endpoint is your go-to solution.</p>\n<h4 id=\"4-donate\">4. Donate</h4>\n<p>Endpoint: <code>v1/donate</code></p>\n<p>Use this endpoint to request donation handling for <strong>bulky</strong>, <strong>oversized</strong>, or <strong>specialized</strong> items that may not be suitable for standard shipping or direct delivery to a nonprofit location.</p>\n<p>This endpoint is intended for items that require alternative coordination, such as pickup, special handling, or manual review.</p>\n<p>With these endpoints, you can streamline your retailer operations, efficiently match items to nonprofits, and facilitate hassle-free shipping processes. Stay tuned for detailed documentation on request formats, parameters, and response structures for each endpoint.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"21205794","collectionId":"ec7f2f6a-ed76-4918-8a58-1fcc1572f832","publishedId":"2sA3QteBZu","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-03-28T17:21:54.000Z"},"item":[{"name":"v1/setupRetailer","id":"a6b27c8e-d96d-4c99-9d51-888fac5830ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}","type":"text"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}","type":"text"}],"body":{"mode":"raw","raw":"{\n    \"retailer\": {\n        \"name\": \"LiquiDonate - Test Child\",\n        \"businessPhoneNumber\": \"123456789\",\n        \"businessAddress\": {\n            \"streetAddress1\": \"149 New Montgomery Street\",\n            \"streetAddress2\": \"Floor 4\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 137.000,\n            \"longitude\": 12.0000\n        },\n        \"shopifyShopID\": \"1234567890\",\n        \"website\": \"1234567890\",\n        \"description\": \"https://www.liquidonate.com\"\n    },\n    \"user\": {\n        \"firstName\": \"Aisya\",\n        \"lastName\": \"Aziz\",\n        \"email\": \"aisya@liquidonate.com\",\n        \"phone\": \"1234567890\"\n    }\n}\n","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/setupRetailer","urlObject":{"path":["v1","setupRetailer"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"5889c797-b188-4d9b-a25d-d46fb970dbe0","name":"Sample Response","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"retailer\": {\n        \"name\": \"LiquiDonate\",\n        \"businessPhoneNumber\": \"123456789\",\n        \"businessAddress\": {\n            \"streetAddress1\": \"149 New Montgomery Street\",\n            \"streetAddress2\": \"Floor 4\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 137.000,\n            \"longitude\": 12.0000\n        },\n        \"shopifyShopID\": \"1234567890\",\n        \"website\": \"1234567890\",\n        \"description\": \"https://www.liquidonate.com\"\n    },\n    \"user\": {\n        \"firstName\": \"Aisya\",\n        \"lastName\": \"Aziz\",\n        \"email\": \"aisya@liquidonate.com\",\n        \"phone\": \"1234567890\"\n    }\n}\n","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/setupRetailer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"628e531dbd6a7f8079fd367eb0989e0a;o=1"},{"key":"Date","value":"Thu, 06 Jun 2024 08:57:43 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"201"}],"cookie":[],"responseTime":null,"body":"{\n    \"retailer\": {\n        \"uuid\": \"bdf80b3a-1dad-4d2f-b5fd-94a6b7f733e2\",\n        \"name\": \"LiquiDonate\"\n    },\n    \"user\": {\n        \"uuid\": \"ed509366-d6de-49b3-ae59-d6025e4446b3\"\n    },\n    \"apiKey\": {\n        \"key\": \"ld_3ZQl1ZdXOz63\",\n        \"secret\": \"ld_sk_rYTmfXXYUyHk\"\n    }\n}"}],"_postman_id":"a6b27c8e-d96d-4c99-9d51-888fac5830ca"},{"name":"v1/getRetailer","id":"270ec967-17d1-486d-8e26-c103c99156cf","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"url":"{{HOST}}/v1/getRetailer","urlObject":{"path":["v1","getRetailer"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"96fcd78e-c18f-404b-b7e1-1b01a302f800","name":"Sample Response","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"url":"{{HOST}}/v1/getRetailer"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"0343ef78cdbb381b1ed52469d8dba839;o=1"},{"key":"Date","value":"Thu, 06 Jun 2024 08:58:45 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"175"}],"cookie":[],"responseTime":null,"body":"{\n    \"retailer\": {\n        \"description\": \"https://www.liquidonate.com\",\n        \"name\": \"LiquiDonate\",\n        \"phone_number\": \"123456789\",\n        \"uuid\": \"bdf80b3a-1dad-4d2f-b5fd-94a6b7f733e2\",\n        \"website\": \"1234567890\"\n    }\n}"}],"_postman_id":"270ec967-17d1-486d-8e26-c103c99156cf"},{"name":"v1/matchAndShip","id":"a58406d0-b56d-41e3-af94-24fb8a4b6911","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"Test\",\n        \"lastName\": \"ABV\",\n        \"email\": \"hello@abc.com\",\n        \"contactNumber\": \"5555555555\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"190 Founders Prom\",\n            \"city\": \"Getzville\",\n            \"state\": \"NY\",\n            \"zip\": \"14068\",\n            \"countryCode\": \"US\"\n        }\n    },\n    \"parcel\": {\n        \"weight\": 2.7\n    },\n    \"items\": [\n        {\n            \"title\": \"Original Bag - Ivory\",\n            \"sku\": \"ABV001\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 2.5\n        },\n        {\n            \"title\": \"Stroller Straps - Ivory\",\n            \"sku\": \"ABV332\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 0.18\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip","description":"<p><strong>Purpose:</strong></p>\n<p>Use this endpoint to create a shipment for a customer-direct donation or return that can be delivered via <strong>standard parcel services</strong>. This workflow generates a shipping label and completes the shipment to the matched nonprofit.</p>\n<p>For <strong>shipping cost estimates</strong> and to preview the nonprofit match, you can call <strong><code>v1/matchAndShip/estimate</code></strong> first. Use the returned <strong>Match UUID</strong> in this request to ensure the same match and rate are applied.</p>\n<hr />\n<h3 id=\"optional-parameters\">Optional Parameters</h3>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Parameter</th>\n<th>Type</th>\n<th>Required</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>match_uuid</code></td>\n<td>string</td>\n<td>Optional (recommended if called from <code>/estimate</code>)</td>\n<td>UUID returned from <code>v1/matchAndShip/estimate</code> to ensure consistent match and rate.</td>\n</tr>\n<tr>\n<td><code>order_id</code></td>\n<td>string</td>\n<td>Optional</td>\n<td>Identifier for the order associated with the shipment.</td>\n</tr>\n<tr>\n<td><code>rma_id</code></td>\n<td>string</td>\n<td>Optional</td>\n<td>Return Merchandise Authorization ID, if applicable.</td>\n</tr>\n<tr>\n<td>retailer_uuid</td>\n<td>string</td>\n<td>Optional</td>\n<td>Child Retailer UUID (optional). The child retailer must be associated with the retailer tied to the API key. This field only applies when creating a match on behalf of a linked retailer.</td>\n</tr>\n</tbody>\n</table>\n</div><hr />\n<h3 id=\"when-to-use-v1matchandship\">When to use <code>v1/matchAndShip</code></h3>\n<p>Use this endpoint when:</p>\n<ul>\n<li><p>The item can be shipped using <strong>standard parcel services</strong></p>\n</li>\n<li><p>The shipment requires <strong>one shipping label</strong></p>\n</li>\n<li><p>The package can be delivered <strong>directly to the nonprofit</strong></p>\n</li>\n<li><p>You want to leverage a <strong>nonprofit match</strong> for the return or donation</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"typical-use-cases\">Typical Use Cases</h3>\n<p>Examples include:</p>\n<ul>\n<li><p>Apparel, shoes, or accessories</p>\n</li>\n<li><p>Books, school supplies, or toys</p>\n</li>\n<li><p>Small household goods or electronics that fit within standard parcel limits</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"important-notes\">Important Notes</h3>\n<ul>\n<li><p>You may <strong>call</strong> <strong><code>/estimate</code></strong> <strong>first</strong> to preview shipping rates and the matched nonprofit. Pass the returned <strong>Match UUID</strong> here for consistency.</p>\n</li>\n<li><p>For <strong>bulky items</strong>, <strong>multi-package shipments</strong>, or items requiring <strong>pickup scheduling or timeslots</strong>, use <code>v1/donate</code> instead.</p>\n</li>\n<li><p>Items exceeding weight limits, falling under excluded categories, or marked as damaged may be ineligible for <code>matchAndShip</code> (see Exclusions section).</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"categorytype\"><code>categoryType</code></h3>\n<p><strong>Description:</strong></p>\n<p>Specifies the category of the item being matched and shipped.</p>\n<p><strong>Accepted values for</strong> <strong><code>categoryType</code>****:</strong></p>\n<p>\"packaged_food_and_snacks\"<br />\"masculine\"<br />\"sports\"<br />\"personal_hygiene\"<br />\"non_fiction_books\"<br />\"cats\"<br />\"pillows\"<br />\"packaged_foods_and_snacks\"<br />\"electronics\"<br />\"health_products\"<br />\"pain_relief\"<br />\"rugs__blankets\"<br />\"electronic_accessories\"<br />\"living_room\"<br />\"feminine\"<br />\"kids\"<br />\"school_supplies\"<br />\"furniture\"<br />\"textbooks\"<br />\"other_electronics\"<br />\"office_supplies\"<br />\"office_furniture\"<br />\"prepared_meals\"<br />\"all\"<br />\"other_pets\"<br />\"outdoor_gear_other\"<br />\"beauty_products\"<br />\"arts__crafts\"<br />\"personal_care\"<br />\"office_goods\"<br />\"shelf_stable_milk\"<br />\"outdoor_gear\"<br />\"books\"<br />\"clothing\"<br />\"fiction_books\"<br />\"home_goods\"<br />\"home_furniture\"<br />\"perishable\"<br />\"food\"<br />\"laptops_and_computers\"<br />\"first_aid\"<br />\"mobile_phones\"<br />\"pharmacy\"<br />\"adaptiveassistive_equipment__ppe\"<br />\"pet_supplies\"<br />\"camping\"<br />\"outdoor_furniture\"<br />\"beverages\"<br />\"non_perishable\"<br />\"glasses__eyewear\"<br />\"canned_foods\"<br />\"dogs\"<br />\"laptops__desktop_computers\"<br />\"monitors\"<br />\"audio_equipment\"<br />\"cell_phones\"<br />\"televisions\"<br />\"bathroom_organization\"<br />\"storage__organization\"<br />\"bathroom_accessories\"<br />\"sexual_wellness\"<br />\"seasonal_home_decor\"<br />\"decor\"<br />\"family\"<br />\"packing__shipping\"<br />\"masculine_shoes\"<br />\"kids_socks__underwear\"<br />\"masculine_clothing\"<br />\"masculine_formal_wear\"<br />\"masculine_costumes\"<br />\"supplements\"<br />\"kids_outerwear\"<br />\"masculine_outerwear\"<br />\"diapers__baby_wipes\"<br />\"kids_shoes\"<br />\"kids_clothing\"<br />\"masculine_jewelry__accessories\"<br />\"feminine_jewelry__accessories\"<br />\"feminine_shoes\"<br />\"masculine_socks__underwear\"<br />\"feminine_socks__underwear\"<br />\"feminine_formal_wear\"<br />\"makeup\"<br />\"baby_supplies\"<br />\"strollers__car_seats\"<br />\"baby_formula__food\"<br />\"hair_care\"<br />\"skin_care\"<br />\"audiovideo\"<br />\"bedding\"<br />\"raw_materials\"<br />\"games__activities\"<br />\"small_appliances\"<br />\"book_bags\"<br />\"cookware\"<br />\"towels_rugs_mats\"<br />\"shower_curtains\"<br />\"classroom_supplies\"<br />\"toys__games\"<br />\"holiday__seasonal\"<br />\"lunch_bags\"<br />\"bedmattress\"<br />\"lamps__lighting\"<br />\"desks\"<br />\"media_players\"<br />\"seating\"<br />\"appliances\"<br />\"office_organization\"<br />\"office_storage__organization\"<br />\"feeding\"<br />\"equipment\"<br />\"gaming_consoles\"<br />\"tablets\"<br />\"backpacking\"<br />\"tents\"<br />\"winter_sports\"<br />\"cycling\"<br />\"nursery\"<br />\"toys__activities\"<br />\"storage__hard_drives\"<br />\"videophoto_cameras\"<br />\"exercise__fitness\"<br />\"accessories\"<br />\"water_sports\"<br />\"playsets\"<br />\"cleaning\"<br />\"sleeping_bags\"<br />\"miscellaneous_gear\"<br />\"camp_cooking\"<br />\"tools\"<br />\"holiday_decorations\"<br />\"maintenance_equipment\"<br />\"home_storage__organization\"<br />\"metals\"<br />\"other_raw_materials\"<br />\"tables\"<br />\"kitchen\"<br />\"bedroom\"<br />\"bathroom\"<br />\"cat_food\"<br />\"cat_health_and_general_supplies\"<br />\"dog_food\"<br />\"dog_toys\"<br />\"other_pet_food\"<br />\"other_pet_toys\"<br />\"liquids\"<br />\"wood_supplies\"<br />\"stoneceramics\"<br />\"glass\"<br />\"textiles\"<br />\"cat_toys\"<br />\"tableware\"<br />\"paper_products\"<br />\"other_pet_health_and_general_supplies\"<br />\"dog_health_and_general_supplies\"<br />\"adaptiveassistive\"<br />\"writingdrawing\"<br />\"feminine_costumes\"<br />\"children\"<br />\"home_seating\"<br />\"infant\"<br />\"kids_costumes\"<br />\"kids_accessories\"<br />\"feminine_clothing\"<br />\"window_accessories\"<br />\"masculine__swimwear\"<br />\"feminine__swimwear\"<br />\"kids__swimwear\"<br />\"feminine_outerwear\"<br />\"party_supplies\"</p>\n<h3 id=\"exclusions\">Exclusions</h3>\n<p>The following items are <strong>not supported</strong> for the initial release of <code>v1/matchAndShip</code>.</p>\n<p>Requests that meet any of the conditions below may be rejected or returned as ineligible for matching and shipment.</p>\n<hr />\n<h4 id=\"category-exclusions\">Category Exclusions</h4>\n<p>Items belonging to the following categories are excluded:</p>\n<ul>\n<li><p><strong>Furniture</strong> <em>(We'd suggest v1/donate endpoint for this)</em></p>\n</li>\n<li><p><strong>Mattress</strong> <em>(We'd suggest v1/donate endpoint for this)</em></p>\n</li>\n<li><p><strong>Drug paraphernalia</strong></p>\n</li>\n</ul>\n<hr />\n<h4 id=\"weight-limit\">Weight Limit</h4>\n<p>Items exceeding the following weight threshold are excluded:</p>\n<ul>\n<li><strong>Greater than 50 kg</strong> <em>(We'd suggest v1/donate endpoint for this)</em></li>\n</ul>\n<hr />\n<h4 id=\"return-reason-exclusion\">Return Reason Exclusion</h4>\n<p>Items with the following return reason are excluded:</p>\n<ul>\n<li>Damaged</li>\n</ul>\n","urlObject":{"path":["v1","matchAndShip"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"daead576-8721-4cf5-b2ca-30dbcb34b737","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"match_uuid\": \"0509dc14-dd2d-4e36-812b-52a4b2765255\",\n    \"order_id\": \"012394\",\n    \"rma_id\": \"012394-R\",\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"1234567890\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"items\": [\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"500\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 4.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"501\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 5.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"502\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 6.0\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"6afc1c05f74979463a92a6edfeb27fd1;o=1"},{"key":"Date","value":"Fri, 07 Jun 2024 04:15:36 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"1242"}],"cookie":[],"responseTime":null,"body":"{\n    \"match\": {\n        \"uuid\": \"0509dc14-dd2d-4e36-812b-52a4b2765255\",\n        \"nonprofit\": {\n            \"organizationName\": \"Woodstock Area Counsel On Aging\",\n            \"website\": \"https://woodstockareacounselonaging.org\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": null,\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 38.77497,\n                \"longitude\": -122.431297\n            }\n        },\n        \"distanceMiles\": \"0\",\n        \"items\": [\n            {\n                \"uuid\": \"6e781121-14ce-4fdd-86cf-918f6472adca\",\n                \"title\": \"MacBook Pro 13\",\n                \"sku\": \"500\",\n                \"quantity\": \"3\",\n                \"weight\": 4\n            },\n            {\n                \"uuid\": \"a06fa0ba-2a1b-4f4f-9473-80ce02dbf698\",\n                \"title\": \"MacBook Pro 13\",\n                \"sku\": \"501\",\n                \"quantity\": \"3\",\n                \"weight\": 5\n            },\n            {\n                \"uuid\": \"7a1b023f-e0b1-4593-907e-31e96a82dcd3\",\n                \"title\": \"MacBook Pro 13\",\n                \"sku\": \"502\",\n                \"quantity\": \"3\",\n                \"weight\": 6\n            }\n        ],\n        \"label\": {\n            \"trackingNumber\": \"9405500110368049165575\",\n            \"carrier\": \"USPS\",\n            \"labelURL\": \"https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240607/e850f7940ff8b84b3bb6eb5bd8d24fac73.png\",\n            \"rate\": {\n                \"id\": \"\",\n                \"shipment_detail\": null,\n                \"value\": \"38.33\",\n                \"currencyCode\": \"USD\"\n            }\n        },\n        \"sourceLocation\": {\n            \"name\": \"\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": null,\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 38.77497,\n                \"longitude\": -122.431297\n            },\n            \"contactNumber\": \"\"\n        }\n    }\n}"},{"id":"79fd4e6f-9246-4384-af66-a0b8807b6f99","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"1234567890\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"items\": [\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"500\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 4.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"501\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 5.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"502\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 6.0\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"df30353e615a60ebce35cb96e0ad9a78;o=1"},{"key":"Date","value":"Thu, 06 Jun 2024 09:00:56 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"88"}],"cookie":[],"responseTime":null,"body":"{\n    \"cause\": \"error buying label\",\n    \"code\": \"retrieve_rate_error\",\n    \"error\": \"error buying label\"\n}"},{"id":"fcf15393-11a6-4f03-9411-edbdb766b67f","name":"Child Retailer (Failed)","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"Test\",\n        \"lastName\": \"ABV\",\n        \"email\": \"hello@abc.com\",\n        \"contactNumber\": \"5555555555\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"190 Founders Prom\",\n            \"city\": \"Getzville\",\n            \"state\": \"NY\",\n            \"zip\": \"14068\",\n            \"countryCode\": \"US\"\n        }\n    },\n    \"parcel\": {\n        \"weight\": 2.7\n    },\n    \"items\": [\n        {\n            \"title\": \"Original Bag - Ivory\",\n            \"sku\": \"ABV001\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 2.5\n        },\n        {\n            \"title\": \"Stroller Straps - Ivory\",\n            \"sku\": \"ABV332\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 0.18\n        }\n    ],\n    \"retailer_uuid\": \"7db3198b-10d4-4a05-a658-c587e2e66485\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip"},"status":"Forbidden","code":403,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Vary","value":"Origin"},{"key":"Date","value":"Thu, 30 Apr 2026 09:18:41 GMT"},{"key":"Content-Length","value":"64"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": \"retailer_not_found\",\n    \"error\": \"child retailer not found\"\n}"},{"id":"8e38b9fb-84a8-431c-9749-0bcebf6b854b","name":"Child Retailer (Successful)","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"Test\",\n        \"lastName\": \"ABV\",\n        \"email\": \"hello@abc.com\",\n        \"contactNumber\": \"5555555555\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"190 Founders Prom\",\n            \"city\": \"Getzville\",\n            \"state\": \"NY\",\n            \"zip\": \"14068\",\n            \"countryCode\": \"US\"\n        }\n    },\n    \"parcel\": {\n        \"weight\": 2.7\n    },\n    \"items\": [\n        {\n            \"title\": \"Original Bag - Ivory\",\n            \"sku\": \"ABV001\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 2.5\n        },\n        {\n            \"title\": \"Stroller Straps - Ivory\",\n            \"sku\": \"ABV332\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 0.18\n        }\n    ],\n    \"retailer_uuid\": \"9e9fccde-c97e-42e5-8ca8-ddad033c6189\"\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Vary","value":"Origin"},{"key":"Date","value":"Thu, 30 Apr 2026 09:17:46 GMT"},{"key":"Content-Length","value":"1199"}],"cookie":[],"responseTime":null,"body":"{\n    \"match\": {\n        \"uuid\": \"d52ec276-979c-4e6d-8320-9e55a56cb5b3\",\n        \"rma_id\": null,\n        \"nonprofit\": {\n            \"organizationName\": \"Nonprofit Aisya\",\n            \"website\": \"www.theaisyaaziz.com\",\n            \"address\": {\n                \"streetAddress1\": \"265 Northampton Street\",\n                \"streetAddress2\": null,\n                \"city\": \"Buffalo\",\n                \"state\": \"NY\",\n                \"zip\": \"14208-2304\",\n                \"countryCode\": \"US\",\n                \"latitude\": 42.9073288,\n                \"longitude\": -78.8570242\n            }\n        },\n        \"distanceMiles\": \"7.38\",\n        \"rate\": \"36.94\",\n        \"items\": [\n            {\n                \"uuid\": \"6681ece2-a451-4cc3-a269-261932ba7e1d\",\n                \"title\": \"Original Bag - Ivory\",\n                \"sku\": \"ABV001\",\n                \"quantity\": \"1\",\n                \"weight\": 2.5\n            },\n            {\n                \"uuid\": \"aceacf43-8ff3-4261-909d-b153ddb283d6\",\n                \"title\": \"Stroller Straps - Ivory\",\n                \"sku\": \"ABV332\",\n                \"quantity\": \"1\",\n                \"weight\": 0.18\n            }\n        ],\n        \"label\": {\n            \"trackingNumber\": \"61292000676723363923\",\n            \"carrier\": \"FedExDefault\",\n            \"labelURL\": \"https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20260430/e8cb398ddcbe054b24972a5cd03f5f2a49.png\",\n            \"rate\": {\n                \"id\": \"\",\n                \"shipment_detail\": null,\n                \"value\": \"20.94\",\n                \"currencyCode\": \"USD\"\n            }\n        },\n        \"sourceLocation\": {\n            \"name\": \"\",\n            \"address\": {\n                \"streetAddress1\": \"190 Founders Prom\",\n                \"streetAddress2\": null,\n                \"city\": \"Getzville\",\n                \"state\": \"NY\",\n                \"zip\": \"14068\",\n                \"countryCode\": \"US\",\n                \"latitude\": 43.0010444,\n                \"longitude\": -78.7877504\n            },\n            \"contactNumber\": \"\",\n            \"contactEmail\": \"\",\n            \"notes\": null\n        },\n        \"labels\": null\n    }\n}"}],"_postman_id":"a58406d0-b56d-41e3-af94-24fb8a4b6911"},{"name":"v1/matchAndShip/estimate","id":"fa51adc6-7654-4327-a08b-d0060a00c162","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"Test\",\n        \"lastName\": \"ABV\",\n        \"email\": \"hello@abc.com\",\n        \"contactNumber\": \"5555555555\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"190 Founders Prom\",\n            \"city\": \"Getzville\",\n            \"state\": \"NY\",\n            \"zip\": \"14068\",\n            \"countryCode\": \"US\"\n        }\n    },\n    \"parcel\": {\n        \"weight\": 2.7\n    },\n    \"items\": [\n        {\n            \"title\": \"Original Bag - Ivory\",\n            \"sku\": \"ABV001\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 2.5\n        },\n        {\n            \"title\": \"Stroller Straps - Ivory\",\n            \"sku\": \"ABV332\",\n            \"description\": \"\",\n            \"quantity\": 1,\n            \"categoryTypes\": [\n                \"feminine\"\n            ],\n            \"weightLbs\": 0.18\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip/estimate","description":"<p><strong>Purpose:</strong><br />Use this endpoint to retrieve a nonprofit match and receive a <strong>shipping cost estimate</strong> for a customer-direct return.</p>\n<p>This endpoint does not create a shipment. It provides the estimated rate and generates a <strong>Match UUID</strong>, which should be used to complete fulfillment via <code>v1/matchAndShip</code>.</p>\n<hr />\n<h3 id=\"when-to-use-v1matchandshipestimate\">When to use <code>v1/matchAndShip/estimate</code></h3>\n<p>Use this endpoint when:</p>\n<ul>\n<li><p>The return is being shipped <strong>directly from the customer</strong></p>\n</li>\n<li><p>A nonprofit match is required</p>\n</li>\n<li><p>You need to obtain a <strong>shipping rate estimate</strong> before creating the shipment</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"required-follow-up-action\">Required Follow-Up Action</h3>\n<p>After receiving the response from <code>v1/matchAndShip/estimate</code>, you should call <code>v1/matchAndShip</code> using the returned <strong>Match UUID</strong> to finalize the shipment.</p>\n<p><strong>Important:</strong><br />Always pass the same <strong>Match UUID</strong> from <code>v1/matchAndShip/estimate</code> into <code>v1/matchAndShip</code> to ensure the same nonprofit match and shipping rate are used.</p>\n<hr />\n<h3 id=\"related-workflow-guidance\">Related Workflow Guidance</h3>\n<p><strong>Customer-to-Nonprofit (Direct Match &amp; Ship)</strong></p>\n<ol>\n<li><p>Call <code>v1/matchAndShip/estimate</code> to receive a nonprofit match and shipping rate estimate</p>\n</li>\n<li><p>Call <code>v1/matchAndShip</code> to create the shipment using the returned <strong>Match UUID</strong></p>\n</li>\n</ol>\n<p><strong>Warehouse or Fixed Address Shipment</strong></p>\n<p>Use <code>v1/ship</code> when the item is already at a warehouse or the destination address is fixed.</p>\n<h3 id=\"exclusions\">Exclusions</h3>\n<p>The following items are <strong>not supported</strong> for the initial release of <code>v1/matchAndShip</code>.</p>\n<p>Requests that meet any of the conditions below may be rejected or returned as ineligible for matching and shipment.</p>\n<hr />\n<h4 id=\"category-exclusions\">Category Exclusions</h4>\n<p>Items belonging to the following categories are excluded:</p>\n<ul>\n<li><p><strong>Furniture</strong> <em>(We'd suggest v1/donate endpoint for this)</em></p>\n</li>\n<li><p><strong>Mattress</strong> <em>(We'd suggest v1/donate endpoint for this)</em></p>\n</li>\n<li><p><strong>Drug paraphernalia</strong></p>\n</li>\n</ul>\n<hr />\n<h4 id=\"weight-limit\">Weight Limit</h4>\n<p>Items exceeding the following weight threshold are excluded:</p>\n<ul>\n<li><strong>Greater than 50 kg</strong> <em>(We'd suggest v1/donate endpoint for this)</em></li>\n</ul>\n<hr />\n<h4 id=\"return-reason-exclusion\">Return Reason Exclusion</h4>\n<p>Items with the following return reason are excluded:</p>\n<ul>\n<li>Damaged</li>\n</ul>\n","urlObject":{"path":["v1","matchAndShip","estimate"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"10ca878f-69d9-470b-ab47-87dd5cdfd9a6","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"1234567890\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"items\": [\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"500\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 4.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"501\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 5.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"502\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 6.0\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"6afc1c05f74979463a92a6edfeb27fd1;o=1"},{"key":"Date","value":"Fri, 07 Jun 2024 04:15:36 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"1242"}],"cookie":[],"responseTime":null,"body":"{\n    \"match\": {\n        \"uuid\": \"0509dc14-dd2d-4e36-812b-52a4b2765255\",\n        \"nonprofit\": {\n            \"organizationName\": \"Woodstock Area Counsel On Aging\",\n            \"website\": \"https://woodstockareacounselonaging.org\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": null,\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 38.77497,\n                \"longitude\": -122.431297\n            }\n        },\n        \"distanceMiles\": \"0\",\n        \"items\": [\n            {\n                \"uuid\": \"6e781121-14ce-4fdd-86cf-918f6472adca\",\n                \"title\": \"MacBook Pro 13\",\n                \"sku\": \"500\",\n                \"quantity\": \"3\",\n                \"weight\": 4\n            },\n            {\n                \"uuid\": \"a06fa0ba-2a1b-4f4f-9473-80ce02dbf698\",\n                \"title\": \"MacBook Pro 13\",\n                \"sku\": \"501\",\n                \"quantity\": \"3\",\n                \"weight\": 5\n            },\n            {\n                \"uuid\": \"7a1b023f-e0b1-4593-907e-31e96a82dcd3\",\n                \"title\": \"MacBook Pro 13\",\n                \"sku\": \"502\",\n                \"quantity\": \"3\",\n                \"weight\": 6\n            }\n        ],\n        \"label\": {\n            \"trackingNumber\": \"9405500110368049165575\",\n            \"carrier\": \"USPS\",\n            \"labelURL\": \"https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240607/e850f7940ff8b84b3bb6eb5bd8d24fac73.png\",\n            \"rate\": {\n                \"id\": \"\",\n                \"shipment_detail\": null,\n                \"value\": \"38.33\",\n                \"currencyCode\": \"USD\"\n            }\n        },\n        \"sourceLocation\": {\n            \"name\": \"\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": null,\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 38.77497,\n                \"longitude\": -122.431297\n            },\n            \"contactNumber\": \"\"\n        }\n    }\n}"},{"id":"9f36ad1b-6cff-4b2d-b62b-c80310451665","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"1234567890\"\n    },\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"items\": [\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"500\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 4.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"501\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 5.0\n        },\n        {\n            \"title\": \"MacBook Pro 13\",\n            \"sku\": \"502\",\n            \"description\": \"description\",\n            \"quantity\": 3,\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"weightLbs\": 6.0\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/matchAndShip"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"df30353e615a60ebce35cb96e0ad9a78;o=1"},{"key":"Date","value":"Thu, 06 Jun 2024 09:00:56 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"88"}],"cookie":[],"responseTime":null,"body":"{\n    \"cause\": \"error buying label\",\n    \"code\": \"retrieve_rate_error\",\n    \"error\": \"error buying label\"\n}"}],"_postman_id":"fa51adc6-7654-4327-a08b-d0060a00c162"},{"name":"v1/ship","id":"cf7aae54-eb65-4eb7-b598-a13160eb093f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"123456789\"\n    },\n    \"source_location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"destination_location\": {\n        \"address\": {\n             \"streetAddress1\": \"1007 sutter st\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94109\",\n            \"countryCode\": \"US\",\n            \"latitude\": 37.78798780105987,\n            \"longitude\":  -122.41700768673985\n        }\n    },\n   \"parcel\": {\n    \"weight\": 15\n   }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/ship","description":"<p><strong>Purpose:</strong><br />Use this endpoint to create a shipment for returns originating from a <strong>warehouse</strong> or being sent to a <strong>fixed address</strong>.</p>\n<p>This endpoint does not perform nonprofit matching. And no donation receipts will be generated for v1/ship.</p>\n<p><strong>Important:</strong><br />Do <strong>not</strong> use <code>v1/match</code> with <code>v1/ship.</code>  </p>\n<p>These endpoints are part of separate workflows.</p>\n<hr />\n<h3 id=\"when-to-use-v1ship\">When to use <code>v1/ship</code></h3>\n<p>Use <code>v1/ship</code> when:</p>\n<ul>\n<li><p>The return item is already at a <strong>warehouse</strong>, fulfillment center, or store location</p>\n</li>\n<li><p>The destination address is <strong>known and fixed</strong></p>\n</li>\n<li><p>No nonprofit matching is required</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"related-workflow-guidance\">Related Workflow Guidance</h3>\n<p><strong>Customer-to-Nonprofit (Direct Match &amp; Ship)</strong>  </p>\n<p>Use the <code>matchAndShip</code> flow:</p>\n<ol>\n<li><p>Call <code>v1/matchAndShip/estimate</code> to receive a nonprofit match and shipping rate estimate</p>\n</li>\n<li><p>Call <code>v1/matchAndShip</code> to finalize the shipment using the returned <strong>Match UUID</strong></p>\n</li>\n</ol>\n<p><strong>Warehouse or Fixed Address Shipment</strong>  </p>\n<p>Use the <code>ship</code> flow:</p>\n<ol>\n<li>Call <code>v1/ship</code> to create the shipment directly to the specified address</li>\n</ol>\n","urlObject":{"path":["v1","ship"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"323f668e-1978-46db-bfea-4a7f15404805","name":"Successful Response","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"123456789\"\n    },\n    \"source_location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"destination_location\": {\n        \"address\": {\n             \"streetAddress1\": \"1007 sutter st\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94109\",\n            \"countryCode\": \"US\",\n            \"latitude\": 37.78798780105987,\n            \"longitude\":  -122.41700768673985\n        }\n    },\n   \"parcel\": {\n    \"weight\": 15\n   }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/ship"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"6fe12a6099883f5e368e6ed07703022e;o=1"},{"key":"Date","value":"Fri, 07 Jun 2024 04:16:19 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"699"}],"cookie":[],"responseTime":null,"body":"{\n    \"from\": {\n        \"name\": \"\",\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"streetAddress2\": null,\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": null,\n            \"longitude\": null\n        },\n        \"contactNumber\": \"\"\n    },\n    \"to\": {\n        \"name\": \"\",\n        \"address\": {\n            \"streetAddress1\": \"1007 sutter st\",\n            \"streetAddress2\": null,\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94109\",\n            \"countryCode\": \"US\",\n            \"latitude\": null,\n            \"longitude\": null\n        },\n        \"contactNumber\": \"\"\n    },\n    \"label\": {\n        \"trackingNumber\": \"9405500110368049165742\",\n        \"carrier\": \"USPS\",\n        \"labelURL\": \"https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20240607/e8cb57a289e7444c2ebad80221b9f9c9eb.png\",\n        \"rate\": {\n            \"id\": \"\",\n            \"shipment_detail\": null,\n            \"value\": \"6.64\",\n            \"currencyCode\": \"USD\"\n        }\n    }\n}"},{"id":"3d392188-deaa-4cdf-95d2-a0d106db1faa","name":"Bad Request","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"123456789\"\n    },\n    \"source_location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    },\n    \"destination_location\": {\n        \"address\": {\n             \"streetAddress1\": \"1007 sutter st\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94109\",\n            \"countryCode\": \"US\",\n            \"latitude\": 37.78798780105987,\n            \"longitude\":  -122.41700768673985\n        }\n    },\n   \"parcel\": {\n    \"weight\": 15\n   }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/ship"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"84aa16b29e46d9a85c9910c1e385582f;o=1"},{"key":"Date","value":"Thu, 06 Jun 2024 09:01:43 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"88"}],"cookie":[],"responseTime":null,"body":"{\n    \"cause\": \"error buying label\",\n    \"code\": \"retrieve_rate_error\",\n    \"error\": \"error buying label\"\n}"}],"_postman_id":"cf7aae54-eb65-4eb7-b598-a13160eb093f"},{"name":"v1/match","id":"2e6ecb5f-88c0-465a-b559-2f454d4c0e0b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"123456789\"\n    },\n    \"items\": [\n        {\n            \"title\": \"MacBook\",\n            \"quantity\": 1,\n            \"description\": \"works\",\n            \"sku\": \"mackbook-1\",\n            \"price\": \"100.00\",\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"conditionTagTypes\": [\n                \"new\"\n            ],\n            \"weightLbs\": 15\n        }\n    ],\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/match","description":"<p><strong>Purpose:</strong></p>\n<p>Use this endpoint to retrieve a nonprofit match for an item.</p>\n<p>If you need a <strong>shipping cost estimation</strong>, please use <code>v1/matchAndShip/estimate</code> instead.</p>\n<p>To complete fulfillment after receiving an estimate, call <code>v1/matchAndShip</code>.</p>\n<p><strong>Recommended flow:</strong></p>\n<ol>\n<li><p>Call <code>v1/matchAndShip/estimate</code> to receive a nonprofit match and shipping rate estimate.</p>\n</li>\n<li><p>Use the returned <strong>Match UUID</strong> to call <code>v1/matchAndShip</code> to finalize the shipment.</p>\n</li>\n</ol>\n<p><strong>Important:</strong><br /><code>v1/match</code> is intended for matching only. It does <strong>not</strong> provide shipping estimates or create shipments.</p>\n<h3 id=\"exclusions\">Exclusions</h3>\n<p>The following items are <strong>not supported</strong> for the initial release of <code>v1/match</code>.</p>\n<p>Requests that meet any of the conditions below may be rejected or returned as ineligible for matching and shipment.</p>\n<hr />\n<h4 id=\"category-exclusions\">Category Exclusions</h4>\n<p>Items belonging to the following categories are excluded:</p>\n<ul>\n<li><p><strong>Furniture</strong> <em>(We'd suggest v1/donate endpoint for this)</em></p>\n</li>\n<li><p><strong>Mattress</strong> <em>(We'd suggest v1/donate endpoint for this)</em></p>\n</li>\n<li><p><strong>Drug paraphernalia</strong></p>\n</li>\n</ul>\n<hr />\n<h4 id=\"weight-limit\">Weight Limit</h4>\n<p>Items exceeding the following weight threshold are excluded:</p>\n<ul>\n<li><strong>Greater than 50 kg</strong> <em>(We'd suggest v1/donate endpoint for this)</em></li>\n</ul>\n<hr />\n<h4 id=\"return-reason-exclusion\">Return Reason Exclusion</h4>\n<p>Items with the following return reason are excluded:</p>\n<ul>\n<li>Damaged</li>\n</ul>\n","urlObject":{"path":["v1","match"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"2483fb38-4ed0-4503-aa1a-5be5a079fce9","name":"Sample Response","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"donor\": {\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"email\": \"john.doe@liquidonate.com\",\n        \"contactNumber\": \"123456789\"\n    },\n    \"items\": [\n        {\n            \"title\": \"MacBook\",\n            \"quantity\": 1,\n            \"description\": \"works\",\n            \"sku\": \"mackbook-1\",\n            \"price\": \"100.00\",\n            \"categoryTypes\": [\n                \"laptops_and_computers\"\n            ],\n            \"conditionTagTypes\": [\n                \"new\"\n            ],\n            \"weightLbs\": 15\n        }\n    ],\n    \"location\": {\n        \"address\": {\n            \"streetAddress1\": \"149 New Montgomery St.\",\n            \"city\": \"San Francisco\",\n            \"state\": \"CA\",\n            \"zip\": \"94105\",\n            \"countryCode\": \"US\",\n            \"latitude\": 38.77497,\n            \"longitude\": -122.431297\n        }\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/match"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"8ea6e47c2836a8287b4fecf7b337136d;o=1"},{"key":"Date","value":"Thu, 06 Jun 2024 09:01:24 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"868"}],"cookie":[],"responseTime":null,"body":"{\n    \"match\": {\n        \"uuid\": \"1adb78e0-45d9-4c03-8dcd-69cf2aa6900c\",\n        \"nonprofit\": {\n            \"organizationName\": \"Woodstock Area Counsel On Aging\",\n            \"website\": \"https://woodstockareacounselonaging.org\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": \"\",\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 38.77497,\n                \"longitude\": -122.431297\n            }\n        },\n        \"distanceMiles\": \"0\",\n        \"items\": [\n            {\n                \"uuid\": \"729ecf33-f102-469e-af77-fc569873b27a\",\n                \"title\": \"MacBook\",\n                \"sku\": \"mackbook-1\",\n                \"quantity\": \"1\",\n                \"weight\": 0\n            }\n        ],\n        \"label\": {\n            \"trackingNumber\": \"\",\n            \"carrier\": \"\",\n            \"labelURL\": \"\",\n            \"rate\": {\n                \"id\": \"\",\n                \"shipment_detail\": null,\n                \"value\": \"0\",\n                \"currencyCode\": \"\"\n            }\n        },\n        \"sourceLocation\": {\n            \"name\": \"\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": null,\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 38.77497,\n                \"longitude\": -122.431297\n            },\n            \"contactNumber\": \"\"\n        }\n    }\n}"}],"_postman_id":"2e6ecb5f-88c0-465a-b559-2f454d4c0e0b"},{"name":"v1/match/ship","id":"afe2da29-7d1a-47ad-8355-4ffc5acabdfc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"match_uuid\": \"fcb6bd00-94e5-4e9d-afeb-c95515f4285a\",\n    \"labels\": [\n        {\n            \"tracking_number\": \"12312312312\",\n            \"carrier\": \"USPS\",\n            \"rate\": {\n                \"amount\": 10.20,\n                \"currencyCode\": \"USD\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/match/ship","description":"<p><strong>Purpose</strong>  </p>\n<p>Use this endpoint to update a match with your own shipping label. This is required if you are shipping items using an existing match.</p>\n<p>If you need a shipping cost estimate, use <code>v1/matchAndShip/estimate</code>. To finalize fulfillment after receiving an estimate, call <code>v1/matchAndShip</code>.</p>\n<hr />\n<p><strong>Recommended Flow</strong></p>\n<ol>\n<li><p>Call <code>v1/matchAndShip/estimate</code> to receive a nonprofit match and shipping rate estimate.</p>\n</li>\n<li><p>Use the returned Match UUID to call <code>v1/matchAndShip</code> and finalize the shipment.</p>\n</li>\n</ol>\n<hr />\n<p><strong>Important</strong></p>\n<ul>\n<li><p><code>v1/match</code> is for matching only. It does not provide shipping estimates or create shipments.</p>\n</li>\n<li><p>If you generate your own shipping label, you must call <code>v1/match/ship</code> after <code>v1/match</code>. This ensures the nonprofit is notified of incoming parcels and that donation receipts can be generated properly.</p>\n</li>\n</ul>\n","urlObject":{"path":["v1","match","ship"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"48322d05-8fd5-421f-a8a8-8a7d70efc9bc","name":"Sample Response","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"match_uuid\": \"fcb6bd00-94e5-4e9d-afeb-c95515f4285a\",\n    \"labels\": [\n        {\n            \"tracking_number\": \"12312312312\",\n            \"tracking_url\": \"https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=12312312312\",\n            \"carrier\": \"USPS\",\n            \"rate\": {\n                \"amount\": 10.20,\n                \"currencyCode\": \"USD\"\n            }\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/match/ship"},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Vary","value":"Origin"},{"key":"Date","value":"Fri, 01 May 2026 04:37:29 GMT"},{"key":"Content-Length","value":"1067"}],"cookie":[],"responseTime":null,"body":"{\n    \"match\": {\n        \"uuid\": \"fcb6bd00-94e5-4e9d-afeb-c95515f4285a\",\n        \"rma_id\": null,\n        \"nonprofit\": {\n            \"organizationName\": \"Nonprofit Aisya\",\n            \"website\": \"www.theaisyaaziz.com\",\n            \"address\": {\n                \"streetAddress1\": \"32990 Lake Wawasee Street\",\n                \"streetAddress2\": \"test\",\n                \"city\": \"Fremont\",\n                \"state\": \"CA\",\n                \"zip\": \"94555\",\n                \"countryCode\": \"US\",\n                \"latitude\": 37.5855289,\n                \"longitude\": -122.0563205\n            }\n        },\n        \"distanceMiles\": \"23.41\",\n        \"rate\": \"0\",\n        \"items\": [\n            {\n                \"uuid\": \"61f2cc9a-03ed-4a62-87a3-9df3ae179060\",\n                \"title\": \"MacBook\",\n                \"sku\": \"mackbook-1\",\n                \"quantity\": \"1\",\n                \"weight\": 15\n            }\n        ],\n        \"label\": {\n            \"trackingNumber\": \"12312312312\",\n            \"carrier\": \"USPS\",\n            \"labelURL\": \"\",\n            \"rate\": {\n                \"id\": \"\",\n                \"shipment_detail\": null,\n                \"value\": \"0\",\n                \"currencyCode\": \"USD\"\n            }\n        },\n        \"sourceLocation\": {\n            \"name\": \"\",\n            \"address\": {\n                \"streetAddress1\": \"149 New Montgomery St.\",\n                \"streetAddress2\": null,\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"zip\": \"94105\",\n                \"countryCode\": \"US\",\n                \"latitude\": 37.7870203,\n                \"longitude\": -122.3997933\n            },\n            \"contactNumber\": \"\",\n            \"contactEmail\": \"\",\n            \"notes\": null\n        },\n        \"labels\": [\n            {\n                \"trackingNumber\": \"12312312312\",\n                \"carrier\": \"USPS\",\n                \"labelURL\": \"\",\n                \"rate\": {\n                    \"id\": \"\",\n                    \"shipment_detail\": null,\n                    \"value\": \"0\",\n                    \"currencyCode\": \"USD\"\n                }\n            }\n        ]\n    }\n}"}],"_postman_id":"afe2da29-7d1a-47ad-8355-4ffc5acabdfc"},{"name":"v1/donate","id":"ae6909a3-e88e-404b-9576-d293e0ec61b3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n        \"title\": \"Example Item\",\n        \"quantity\": 1,\n        \"description\": \"This is an example description.\",\n        \"sizeType\": \"medium\",\n        \"fulfillmentTypes\": [\n            \"pickup\"\n        ],\n        \"recipientTypes\": [\n            \"nonprofit\"\n        ],\n        \"categoryTypes\": [\n            \"electronics\"\n        ],\n        \"fairMarketValue\": {\n            \"value\": 100,\n            \"currencyCode\": \"USD\"\n        },\n        \"conditionTagTypes\": [\n            \"new\"\n        ],\n        \"imageURLs\": [\n            \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n        ],\n        \"location\": {\n            \"name\": \"Aisya\",\n            \"contactNumber\": \"4125124729\",\n            \"address\": {\n                \"streetAddress1\": \"123 Main St\",\n                \"streetAddress2\": null,\n                \"city\": \"New York\",\n                \"state\": \"NY\",\n                \"zip\": \"10001\",\n                \"countryCode\": \"US\",\n                \"latitude\": 40.7128,\n                \"longitude\": -74.0060\n            }\n        },\n        \"unitType\": \"individual_item\",\n        \"weightLbs\": 2.5,\n        \"lengthInches\": 10,\n        \"heightInches\": 5,\n        \"widthInches\": 3\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate","description":"<p><strong>Purpose:</strong></p>\n<p>Use this endpoint to request donation handling for <strong>bulky</strong>, <strong>oversized</strong>, or <strong>specialized</strong> items that may not be suitable for standard shipping or direct delivery to a nonprofit location.</p>\n<p>This endpoint is intended for items that require alternative coordination, such as pickup, special handling, or manual review.</p>\n<hr />\n<h3 id=\"when-to-use-v1donate\">When to use <code>v1/donate</code></h3>\n<p>Use this endpoint when:</p>\n<ul>\n<li><p>The item is <strong>large</strong>, <strong>bulky</strong>, or difficult to ship via standard parcel services</p>\n</li>\n<li><p>The item requires <strong>special handling</strong> or coordination</p>\n</li>\n<li><p>The item may not be appropriate to be shipped directly to a nonprofit’s doorstep</p>\n</li>\n<li><p>The item falls outside the standard <code>matchAndShip</code> workflow</p>\n</li>\n</ul>\n<p>Examples may include:</p>\n<ul>\n<li><p>Large furniture or oversized household items</p>\n</li>\n<li><p>Equipment requiring scheduled pickup</p>\n</li>\n<li><p>Items that require manual coordination with the receiving nonprofit</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"related-workflow-guidance\">Related Workflow Guidance</h3>\n<p><strong>Customer-to-Nonprofit (Standard Parcel Shipment)</strong></p>\n<p>Use the <code>matchAndShip</code> flow:</p>\n<ol>\n<li><p>Call <code>v1/matchAndShip/estimate</code> to receive a nonprofit match and shipping rate estimate</p>\n</li>\n<li><p>Call <code>v1/matchAndShip</code> to finalize the shipment using the returned <strong>Match UUID</strong></p>\n</li>\n</ol>\n","urlObject":{"path":["v1","donate"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"35e187e8-0c30-47ae-bcd1-9ee48e3408d2","name":"Single Donation","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n  \"title\": \"Example Item\",\n  \"quantity\": 1,\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"3724d44f153c1bdfab108377e31d7ff6;o=1"},{"key":"Date","value":"Tue, 16 Jul 2024 22:19:26 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"56"}],"cookie":[],"responseTime":null,"body":"{\n    \"item\": {\n        \"uuid\": \"efab1900-3dd3-48b6-9f1a-1c8ac58ccbec\"\n    }\n}"},{"id":"cad0d8f8-cf2c-497e-a54e-48b6a690e639","name":"Bundle Donation","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n  \"quantity\": 1,\n  \"title\": \"Mattress\",\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3,\n  \"isBundle\": true,\n  \"items\": [\n    {\n        \"quantity\": 1,\n        \"title\": \"Item Inside Mattress\",\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3\n    }\n  ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"df58fc601675d7ecd9398bf3f8f48e3b;o=1"},{"key":"Date","value":"Tue, 16 Jul 2024 22:21:51 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"66"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": \"missing_item_title\",\n    \"error\": \"Item needs to have a title\"\n}"}],"_postman_id":"ae6909a3-e88e-404b-9576-d293e0ec61b3"},{"name":"v1/donate for multiple labels","id":"4a98552c-1499-48fb-8354-3bd28c1faf8b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n        \"title\": \"Example Item\",\n        \"quantity\": 1,\n        \"description\": \"This is an example description.\",\n        \"sizeType\": \"medium\",\n        \"fulfillmentTypes\": [\n            \"pickup\"\n        ],\n        \"recipientTypes\": [\n            \"nonprofit\"\n        ],\n        \"categoryTypes\": [\n            \"electronics\"\n        ],\n        \"fairMarketValue\": {\n            \"value\": 100,\n            \"currencyCode\": \"USD\"\n        },\n        \"conditionTagTypes\": [\n            \"new\"\n        ],\n        \"imageURLs\": [\n            \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n        ],\n        \"location\": {\n            \"name\": \"Aisya\",\n            \"contactNumber\": \"4125124729\",\n            \"address\": {\n                \"streetAddress1\": \"123 Main St\",\n                \"streetAddress2\": null,\n                \"city\": \"New York\",\n                \"state\": \"NY\",\n                \"zip\": \"10001\",\n                \"countryCode\": \"US\",\n                \"latitude\": 40.7128,\n                \"longitude\": -74.0060\n            }\n        },\n        \"unitType\": \"individual_item\",\n        \"weightLbs\": 2.5,\n        \"lengthInches\": 10,\n        \"heightInches\": 5,\n        \"widthInches\": 3,\n        \"requestItemLabels\": [\n            {\n                \"weightInLbs\": 5\n            },\n            {\n                \"weightInLbs\": 7\n            }\n        ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate","description":"<h3 id=\"multiple-label-or-multi-package-items\">Multiple-Label or Multi-Package Items</h3>\n<p>Use <code>v1/donate</code> when a single product or donation requires <strong>multiple shipping labels</strong> or is fulfilled across <strong>multiple packages</strong>.</p>\n<p>This commonly applies to items that are packaged separately but belong to the same donation, where coordination is needed to ensure proper handling and receipt by the nonprofit.</p>\n<hr />\n<h3 id=\"when-to-use-v1donate-for-multi-package-items\">When to use <code>v1/donate</code> for Multi-Package Items</h3>\n<p>Use this endpoint when:</p>\n<ul>\n<li><p>A single product is shipped in <strong>multiple boxes or packages</strong></p>\n</li>\n<li><p>The shipment requires <strong>multiple labels</strong> for the same donation</p>\n</li>\n<li><p>The packages need to be coordinated as part of <strong>one donation event</strong></p>\n</li>\n<li><p>Standard <code>matchAndShip</code> may not be suitable due to complexity in handling or delivery</p>\n</li>\n</ul>\n<p><strong>Example:</strong>  </p>\n<p>A desk that ships in <strong>three separate boxes</strong> (e.g., tabletop, legs, hardware), each requiring its own label, should be processed using <code>v1/donate</code> instead of <code>v1/matchAndShip</code>.</p>\n","urlObject":{"path":["v1","donate"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"efa32cba-8a8f-4528-856d-05fc91e54543","name":"Single Donation","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n  \"title\": \"Example Item\",\n  \"quantity\": 1,\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"3724d44f153c1bdfab108377e31d7ff6;o=1"},{"key":"Date","value":"Tue, 16 Jul 2024 22:19:26 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"56"}],"cookie":[],"responseTime":null,"body":"{\n    \"item\": {\n        \"uuid\": \"efab1900-3dd3-48b6-9f1a-1c8ac58ccbec\"\n    }\n}"},{"id":"1d195207-4dcc-41c7-b742-8571fe3f8841","name":"Bundle Donation","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n  \"quantity\": 1,\n  \"title\": \"Mattress\",\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3,\n  \"isBundle\": true,\n  \"items\": [\n    {\n        \"quantity\": 1,\n        \"title\": \"Item Inside Mattress\",\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3\n    }\n  ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8"},{"key":"vary","value":"Origin"},{"key":"X-Cloud-Trace-Context","value":"df58fc601675d7ecd9398bf3f8f48e3b;o=1"},{"key":"Date","value":"Tue, 16 Jul 2024 22:21:51 GMT"},{"key":"Server","value":"Google Frontend"},{"key":"Content-Length","value":"66"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": \"missing_item_title\",\n    \"error\": \"Item needs to have a title\"\n}"}],"_postman_id":"4a98552c-1499-48fb-8354-3bd28c1faf8b"},{"name":"v1/donate with time slot","id":"d06de367-312c-4a63-ae29-7279a3beb277","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n        \"title\": \"Example Item\",\n        \"quantity\": 1,\n        \"description\": \"This is an example description.\",\n        \"sizeType\": \"medium\",\n        \"fulfillmentTypes\": [\n            \"pickup\"\n        ],\n        \"recipientTypes\": [\n            \"nonprofit\"\n        ],\n        \"categoryTypes\": [\n            \"electronics\"\n        ],\n        \"fairMarketValue\": {\n            \"value\": 100,\n            \"currencyCode\": \"USD\"\n        },\n        \"conditionTagTypes\": [\n            \"new\"\n        ],\n        \"imageURLs\": [\n            \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n        ],\n        \"location\": {\n            \"name\": \"Aisya\",\n            \"contactNumber\": \"4125124729\",\n            \"address\": {\n                \"streetAddress1\": \"123 Main St\",\n                \"streetAddress2\": null,\n                \"city\": \"New York\",\n                \"state\": \"NY\",\n                \"zip\": \"10001\",\n                \"countryCode\": \"US\",\n                \"latitude\": 40.7128,\n                \"longitude\": -74.0060\n            }\n        },\n        \"unitType\": \"individual_item\",\n        \"weightLbs\": 2.5,\n        \"lengthInches\": 10,\n        \"heightInches\": 5,\n        \"widthInches\": 3,\n        \"pickupHours\": {\n            \"timezone\": \"America/Los_Angeles\",\n            \"pickupIntervals\": [\n                {\n                    \"days\": [\"monday\", \"tuesday\"],\n                    \"startTimeLocal\": \"10:00\",\n                    \"endTimeLocal\": \"12:00\"\n                },\n                {\n                    \"days\": [\"monday\", \"tuesday\"],\n                    \"startTimeLocal\": \"12:00\",\n                    \"endTimeLocal\": \"14:00\"\n                }\n            ]\n        }\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate","description":"<h3 id=\"pickup-scheduling-and-timeslot-coordination\">Pickup Scheduling and Timeslot Coordination</h3>\n<p>Use this version of <code>v1/donate</code> when pickup scheduling and timeslot coordination are required to organize logistics.</p>\n<p>This applies to scenarios where the item cannot be shipped via standard parcel services and must be collected through a scheduled pickup, often requiring coordination between the donor, carrier, and receiving organization.</p>\n<hr />\n<h3 id=\"when-to-use-v1donate-for-pickup-and-timeslots\">When to use <code>v1/donate</code> for Pickup and Timeslots</h3>\n<p>Use this endpoint when:</p>\n<ul>\n<li><p>A <strong>pickup</strong> needs to be scheduled instead of shipping a parcel</p>\n</li>\n<li><p>A specific <strong>date and time window</strong> must be coordinated</p>\n</li>\n<li><p>Logistics require <strong>onsite collection</strong> from the customer, warehouse, or store</p>\n</li>\n<li><p>Delivery or pickup must be planned based on availability or capacity constraints</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"typical-use-cases\">Typical Use Cases</h3>\n<p>Examples include:</p>\n<ul>\n<li><p>Bulky items requiring <strong>scheduled pickup</strong></p>\n</li>\n<li><p>Donations that must be collected within a specific <strong>timeslot</strong></p>\n</li>\n<li><p>Locations with <strong>restricted access hours</strong> (e.g., offices, schools, or warehouses)</p>\n</li>\n<li><p>Coordinated logistics involving carriers or moving services</p>\n</li>\n</ul>\n<hr />\n<h3 id=\"important\">Important</h3>\n<p>This request body version enables logistics coordination and scheduling.</p>\n","urlObject":{"path":["v1","donate"],"host":["{{HOST}}"],"query":[],"variable":[]}},"response":[{"id":"20733234-8e30-4141-8e31-4a007a9541ad","name":"Single Donation","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n  \"title\": \"Example Item\",\n  \"quantity\": 1,\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8","uuid":"e31cf96c-8d3d-4849-a6a4-c1088fd9a262"},{"key":"vary","value":"Origin","uuid":"429bb8e0-99ed-4682-93ca-f048ed57528f"},{"key":"X-Cloud-Trace-Context","value":"3724d44f153c1bdfab108377e31d7ff6;o=1","uuid":"4bc0785a-9a5e-4fa5-9cf8-968a96c0fe63"},{"key":"Date","value":"Tue, 16 Jul 2024 22:19:26 GMT","uuid":"f1b81e1d-da69-4f45-ac8d-30bbc7513ee4"},{"key":"Server","value":"Google Frontend","uuid":"034c6afd-1d15-4718-909e-90cab5ae8b5c"},{"key":"Content-Length","value":"56","uuid":"bf293b89-fc55-41e1-8c2c-25dc77246532"}],"cookie":[],"responseTime":null,"body":"{\n    \"item\": {\n        \"uuid\": \"efab1900-3dd3-48b6-9f1a-1c8ac58ccbec\"\n    }\n}"},{"id":"8108d11b-c9df-40e2-8630-ed29b4f7018d","name":"Bundle Donation","originalRequest":{"method":"POST","header":[{"key":"X-LiquiDonate-Key","value":"{{LD_API_KEY}}"},{"key":"X-LiquiDonate-Secret","value":"{{LD_API_SECRET}}"}],"body":{"mode":"raw","raw":"{\n    \"item\": {\n  \"quantity\": 1,\n  \"title\": \"Mattress\",\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3,\n  \"isBundle\": true,\n  \"items\": [\n    {\n        \"quantity\": 1,\n        \"title\": \"Item Inside Mattress\",\n  \"description\": \"This is an example description.\",\n  \"sizeType\": \"medium\",\n  \"fulfillmentTypes\": [\"pickup\"],\n  \"recipientTypes\": [\"nonprofit\"],\n  \"categoryTypes\": [\"electronics\"],\n  \"fairMarketValue\": {\n    \"value\": 100,\n    \"currencyCode\": \"USD\"\n  },\n  \"conditionTagTypes\": [\"new\"],\n  \"imageURLs\": [\n    \"https://imageproxy.liquidonate.com/1500x1200/https://storage.googleapis.com/liquid-images-prod/item-images/bf4624a5-b0cc-4a07-b673-25614e15403c.png\"\n  ],\n  \"location\": {\n    \"name\": \"Aisya\",\n    \"contactNumber\": \"4125124729\",\n    \"address\": {\n        \"streetAddress1\": \"123 Main St\",\n        \"streetAddress2\": null,\n        \"city\": \"New York\",\n        \"state\": \"NY\",\n        \"zip\": \"10001\",\n        \"countryCode\": \"US\",\n        \"latitude\": 40.7128,\n        \"longitude\": -74.0060\n    }\n  },\n  \"unitType\": \"individual_item\",\n  \"weightLbs\": 2.5,\n  \"lengthInches\": 10,\n  \"heightInches\": 5,\n  \"widthInches\": 3\n    }\n  ]\n    }\n}","options":{"raw":{"language":"json"}}},"url":"{{HOST}}/v1/donate"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"content-type","value":"application/json; charset=utf-8","uuid":"9d154a61-cdb1-4253-8be0-64c8ac03a5da"},{"key":"vary","value":"Origin","uuid":"72c49392-9ffd-4d05-af13-9d8c44bb89c9"},{"key":"X-Cloud-Trace-Context","value":"df58fc601675d7ecd9398bf3f8f48e3b;o=1","uuid":"7ac59ffd-e8c0-44b2-9d12-de1bccbcb3a2"},{"key":"Date","value":"Tue, 16 Jul 2024 22:21:51 GMT","uuid":"417183a1-3246-4cca-a8f0-8438d87b58ac"},{"key":"Server","value":"Google Frontend","uuid":"250804e4-764a-4112-9bdb-c08880387a3f"},{"key":"Content-Length","value":"66","uuid":"b547fb27-0ab2-420b-8d48-564a07185470"}],"cookie":[],"responseTime":null,"body":"{\n    \"code\": \"missing_item_title\",\n    \"error\": \"Item needs to have a title\"\n}"}],"_postman_id":"d06de367-312c-4a63-ae29-7279a3beb277"}],"event":[{"listen":"prerequest","script":{"id":"a733982b-e787-4148-9485-fe3daf64c8fe","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"f0ed062b-5f76-4ab9-8437-22d875f5da04","type":"text/javascript","packages":{},"exec":[""]}}]}