Welcome to the Dimona API β your gateway to fast, high-quality direct-to-garment (DTG) printing across the Americas.
\nDimona operates the largest on-demand DTG network in Latin America, with facilities in the U.S., Brazil, Mexico, Argentina, and Chile. Whether you're building an eCommerce store, managing a B2B merch program, or scaling global fulfillment β this API gets your orders printed, packed, and shipped with precision.
\nKey Features:
\nπ¦ Local production, faster delivery
\n𧡠High-quality DTG printing (no minimums)
\nπ International reach with region-optimized logistics
\nExplore the endpoints below to submit orders, check inventory, track production events, and manage your fulfillment workflow.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"111729","collectionId":"6101a42b-ab95-4e2f-8d25-50f6d758485e","publishedId":"Tzz7McgF","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"0165ff"},"publishDate":"2025-05-27T16:15:48.000Z"},"item":[{"name":"Order","item":[{"name":"Submit a production order","id":"be74fc8a-460e-41b9-a997-1a14386fb577","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{usa-api-token}}"},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"id\": \"orderReference1234\",\n \"sample\": true,\n \"reprint\": false,\n \"xqc\": false,\n \"webhook_url\": \"https://webhook.receiver.example/orders\",\n \"ship_by_date\": \"2025-01-15\",\n \"address_to\": {\n \"address1\": \"1983 Tigertail Blvd\",\n \"address2\": \"\",\n \"city\": \"Dania Beach\",\n \"zip\": \"33004\",\n \"country\": \"US\",\n \"region\": \"FL\",\n \"first_name\": \"John\",\n \"last_name\": \"Doe\",\n \"email\": \"john.doe@example.com\",\n \"phone\": \"+1-305-555-1212\"\n },\n \"address_from\": {\n \"address1\": \"1983 Tigertail Blvd\",\n \"address2\": \"\",\n \"city\": \"Dania\",\n \"zip\": \"33004\",\n \"country\": \"US\",\n \"region\": \"FL\",\n \"company\": \"Tee USA LLC\",\n \"email\": \"support@example.com\",\n \"phone\": \"+1-954-555-2020\"\n },\n \"shipping\": {\n \"carrier\": \"USPS\",\n \"priority\": \"Standard\"\n },\n \"items\": [\n {\n \"id\": \"gB0NV05e\",\n \"sku\": \"BLC-3001-BLACK-L\",\n \"preview_files\": {\n \"front\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_mockup.png\",\n \"back\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_mockup.png\",\n \"neck\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_mockup.png\",\n \"left_chest\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_mockup.png\",\n \"right_chest\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_mockup.png\"\n },\n \"print_files\": {\n \"front\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_printfile.png\",\n \"back\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_printfile.png\",\n \"neck\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_printfile.png\",\n \"left_chest\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_printfile.png\",\n \"right_chest\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_1_printfile.png\"\n },\n \"extras\": {\n \"dark\": false,\n \"capabilities\":{\n \"front\": \"DTG\",\n \"back\": \"DTF\",\n \"neck\": \"DTF\",\n \"left_chest\": \"EMB\",\n \"right_chest\": \"EMB\"\n }\n },\n \"quantity\": 1\n },\n {\n \"id\": \"yLA6m0oM\",\n \"sku\": \"BLC-3001-BLACK-L\",\n \"preview_files\": {\n \"front\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_2_mockup.png\"\n },\n \"print_files\": {\n \"front\": \"https://dimona.s3.us-east-1.amazonaws.com/dimonausa/image_2_printfile.png\"\n },\n \"quantity\": 1\n }\n ],\n \"package_inserts\": [\n \"https://pdf_to_4x6_insert.pdf\"\n ],\n \"packing_slip\": \"https://pdf_to_letter_slip.pdf\"\n}"},"url":"{{usa-api-domain}}/api/v2021/orders","description":"Create a new DTG production order to be printed, packed, and shipped from one of our regional facilities.
\nUse this endpoint to send print-ready artwork, shipping details, and item metadata. Orders are automatically validated, assigned to the best facility, and queued for fulfillment.
\nCheck inventory for each SKU before submitting.
\nUse unique order IDs to avoid duplicates.
\nValidate print files (300 DPI, correct format) to avoid quality issues.
\nInclude customer contact for delivery updates and return handling.
\nGet full details of a submitted production order using its reference_id.
This endpoint returns the orderβs current status, shipping details, item list and
tracking info (if shipped).
GET /order/{id}/events.Track order progress in real-time
\nDisplay shipping status and tracking to customers
\nStandard: Pending β In Production β Shipped
Cancelled: Any status β Cancelled (restrictions apply)
id, reference_id
Full address info (address_to, address_from)
status, created_at, updated_at
All items with print files and status
tracking_number
Cancel an order before it enters production or shipping.
\nThis endpoint allows full or partial cancellation of production orders, depending on their current status. You can cancel the entire order or specific items, and optionally provide a reason and notes for better traceability.
\nβ
Pending: Always cancellable
β In Production, Shipped: Not cancellable via API (contact support)
β οΈ Special Cases: Samples and reprints may follow different rules
\nYou can cancel individual items within the order by passing an array of item IDs. The rest of the order continues through the normal flow.
\n","auth":{"type":"bearer","bearer":{"token":"{{usa-api-token}}"},"isInherited":true,"source":{"_postman_id":"6101a42b-ab95-4e2f-8d25-50f6d758485e","id":"6101a42b-ab95-4e2f-8d25-50f6d758485e","name":"Dimona API β Production & Fulfillment","type":"collection"}},"urlObject":{"path":["api","v2021","order","{{order-uuid}}","cancel"],"host":["{{usa-api-domain}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"b52a4c6f-d365-48c3-933c-f5abb13ce105"},{"name":"Retrieve Order Events","id":"5f1baac3-1a19-4c96-a644-5f38f3fe5057","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{usa-api-token}}"},"isInherited":false},"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":""},"url":"{{usa-api-domain}}/api/v2021/order/{{order-uuid}}/events","description":"Fetch a detailed timeline of all production-related events for a given order.
\nUnlike the main order status (which reflects the order as a whole), this endpoint returns granular item-level actions, including printing, packaging, and shipping steps β with timestamps and affected item IDs.
\nVisualize step-by-step progress of an order
\nBuild a production dashboard or internal tracking UI
\nDebug production delays or errors
\nGenerate audit logs or reporting based on actual timestamps
\nEach event contains:
\n","urlObject":{"path":["api","v2021","order","{{order-uuid}}","events"],"host":["{{usa-api-domain}}"],"query":[],"variable":[]}},"response":[{"id":"9a95524b-5efc-4f7d-ae4a-d2893d5bc331","name":"Retrieve Order Events","originalRequest":{"method":"GET","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":""},"url":"{{usa-api-domain}}/api/v2021/order/{{order-uuid}}/events"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 27 May 2025 19:54:30 GMT"},{"key":"X-RateLimit-Limit","value":"120"},{"key":"X-RateLimit-Remaining","value":"119"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"X-Frame-Options","value":"SAMEORIGIN"},{"key":"X-XSS-Protection","value":"1; mode=block"},{"key":"X-Content-Type-Options","value":"nosniff"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"status\": \"shipped\",\n \"events\": [\n {\n \"time\": \"2025-05-27T14:00:05+00:00\",\n \"action\": \"created\",\n \"affected_items\": [\n \"1234\",\n \"1235\",\n \"1236\",\n \"1237\",\n \"pck-insert\"\n ]\n },\n {\n \"time\": \"2025-05-27T15:03:58+00:00\",\n \"action\": \"picked\",\n \"affected_items\": [\n \"1234\",\n \"1235\",\n \"1236\"\n ]\n },\n {\n \"time\": \"2025-05-27T15:03:59+00:00\",\n \"action\": \"picked\",\n \"affected_items\": [\n \"1237\"\n ]\n },\n {\n \"time\": \"2025-05-27T15:11:05+00:00\",\n \"action\": \"printed\",\n \"affected_items\": [\n \"1234\"\n ]\n },\n {\n \"time\": \"2025-05-27T15:11:28+00:00\",\n \"action\": \"printed\",\n \"affected_items\": [\n \"1235\"\n ]\n },\n {\n \"time\": \"2025-05-27T15:11:32+00:00\",\n \"action\": \"printed\",\n \"affected_items\": [\n \"1236\"\n ]\n },\n {\n \"time\": \"2025-05-27T15:30:21+00:00\",\n \"action\": \"printed\",\n \"affected_items\": [\n \"1237\"\n ]\n },\n {\n \"time\": \"2025-05-27T18:10:28+00:00\",\n \"action\": \"packaged\",\n \"affected_items\": [\n \"1234\"\n ]\n },\n {\n \"time\": \"2025-05-27T18:11:05+00:00\",\n \"action\": \"packaged\",\n \"affected_items\": [\n \"1235\"\n ]\n },\n {\n \"time\": \"2025-05-27T18:11:43+00:00\",\n \"action\": \"packaged\",\n \"affected_items\": [\n \"1236\"\n ]\n },\n {\n \"time\": \"2025-05-27T18:12:24+00:00\",\n \"action\": \"packaged\",\n \"affected_items\": [\n \"1237\"\n ]\n },\n {\n \"time\": \"2025-05-27T18:12:29+00:00\",\n \"action\": \"shipped\",\n \"affected_items\": [\n \"1234\",\n \"1235\",\n \"1236\",\n \"1237\"\n ],\n \"tracking_url\": \"https://track.easypost.com/tracking_here\",\n \"tracking_number\": \"Tracking Here\",\n \"carrier\": \"Carrier\"\n }\n ]\n}"}],"_postman_id":"5f1baac3-1a19-4c96-a644-5f38f3fe5057"},{"name":"Submit a production order - Legacy Payload","id":"711af02b-9519-4347-9f04-826185f4428b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{usa-api-token}}"},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"shipping_speed\": \"USPS\",\n \"delivery_method_id\": \"Ground Advantage\",\n \"order_id\": \"your-order-id\",\n \"customer_name\": \"John Doe\",\n \"customer_document\": \"legacy field\",\n \"customer_email\": \"example@gmail.com\",\n \"items\": [\n {\n \"name\": \"legacy field\",\n \"sku\": \"Your Gildan 5000 SKU\",\n \"qty\": 2,\n \"dimona_sku_id\": \"GLD-5000-WHITE-XL\",\n \"designs\": {\n \"front\": \"https://url-to-front\",\n \"back\": \"https://url-to-back\",\n \"left_sleeve\": \"https://url-to-left-sleeve\",\n \"right_sleeve\": \"https://url-to-right-sleeve\",\n \"inner_label\": \"https://url-to-inner-label\",\n \"outer_label\": \"https://url-to-outer-label\"\n },\n \"mocks\": {\n \"front\": \"https://url-to-front-mock\",\n \"back\": \"https://url-to-back-mock\",\n \"left_sleeve\": \"https://url-to-left-sleeve-mock\",\n \"right_sleeve\": \"https://url-to-right-sleeve-mock\",\n \"inner_label\": \"https://url-to-inner-label-mock\",\n \"outer_label\": \"https://url-to-outer-label-mock\"\n }\n }\n ],\n \"nfe\": { \n \"chave\": \"legacy\",\n \"serie\": \"legacy\",\n \"numero\": \"legacy\",\n \"link\": \"legacy\"\n },\n \"address\": {\n \"street\": \"Rua Buenos Aires\",\n \"number\": \"334\",\n \"complement\": \"Loja\",\n \"city\": \"Rio de Janeiro\",\n \"state\": \"RJ\",\n \"zipcode\": \"20061000\",\n \"neighborhood\": \"Centro\",\n \"phone\": \"21 21093661\",\n \"country\": \"BR\"\n }\n}"},"url":"{{usa-api-domain}}/api/v3/orders","description":"Legacy version of the production order submission endpoint, maintained for backward compatibility with older Brazil-based integrations.
\nUse this only if youβre still using the legacy structure from /api/v3/orders. All new integrations should use the standard /api/v2021/orders format.
This endpoint allows systems using the Brazil API format to continue working without immediate migration. Fields are mapped internally to the current standard format.
\nExisting Shopify apps or marketplaces integrated before 2021
\nGradual migration of legacy systems to new API structure
\nInternal tooling still using old payload shape
\ncustomer_document: Not used in U.S. operations
nfe: Tax invoice for Brazil, ignored elsewhere
address.neighborhood: Not part of U.S. addressing format
Brazil Orders: Brazil-specific fields (e.g. nfe, customer_document) are processed
US/International: Those fields are ignored gracefully; U.S. rules applied
\nThis endpoint will continue to function but is deprecated. Please plan to:
\nUpdate your payloads to match the /v2021/orders format
Use field names compatible with the current schema
\nRemove reliance on this endpoint within 12 months
\nRetrieve a paginated list of available SKUs, including stock levels, product specs, and print capabilities.
\nUse this endpoint to browse or sync your product catalog page by page. Itβs optimized for frontend catalog rendering, collection pages, and syncing stock availability for larger datasets.
\nReturns real-time inventory and product details for a single SKU.
\nUse this when you know exactly which SKU you want to check.
\nPOST /api/v2021/inventoryBulk-check stock availability for multiple SKUs at once.
\nSend a list of SKU references in the body to receive their current inventory and status.
\n","urlObject":{"path":["api","v2021","inventory"],"host":["{{usa-api-domain}}"],"query":[],"variable":[]}},"response":[{"id":"d22e3793-0287-49f6-9421-eaa330e7d65b","name":"Get Inventory","originalRequest":{"method":"POST","header":[{"key":"Content-Type","type":"text","value":"application/json"},{"key":"Accept","type":"text","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"SKU\": [\n \"BLC-3001-WHITE-XL\",\n \"BLC-3001-WHITE-L\",\n \"BLC-3001-WHITE-M\"\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{usa-api-domain}}/api/v2021/inventory"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Server","value":"nginx/1.18.0 (Ubuntu)"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Cache-Control","value":"no-cache, private"},{"key":"Date","value":"Tue, 22 Mar 2022 22:09:23 GMT"},{"key":"X-RateLimit-Limit","value":"120"},{"key":"X-RateLimit-Remaining","value":"117"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"items\": [\n {\n \"SKU\": \"BLC-3001-WHITE-L\",\n \"amount\": 10061,\n \"status\": \"in-stock\"\n },\n {\n \"SKU\": \"BLC-3001-WHITE-M\",\n \"amount\": 10062,\n \"status\": \"in-stock\"\n },\n {\n \"SKU\": \"BLC-3001-WHITE-XL\",\n \"amount\": 10033,\n \"status\": \"in-stock\"\n }\n ]\n}"}],"_postman_id":"3e954e68-8c14-4762-a5e9-a3799f94a64b"}],"id":"e345167b-df61-48c0-a181-3543cc323581","_postman_id":"e345167b-df61-48c0-a181-3543cc323581","description":"","auth":{"type":"bearer","bearer":{"token":"{{usa-api-token}}"},"isInherited":true,"source":{"_postman_id":"6101a42b-ab95-4e2f-8d25-50f6d758485e","id":"6101a42b-ab95-4e2f-8d25-50f6d758485e","name":"Dimona API β Production & Fulfillment","type":"collection"}}},{"name":"Shipping","item":[{"name":"Calculate Shipping Rates","id":"180bd6ed-3669-4a42-86d5-215dff9f8f91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"token":"{{usa-api-token}}"},"isInherited":false},"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Accept","value":"application/json","type":"text"}],"body":{"mode":"raw","raw":"{\n \"recipient\": {\n \"address1\": \"875 Cambridge Drive\",\n \"city\": \"Elk Grove Village\",\n \"state_code\": \"IL\",\n \"country_code\": \"US\",\n \"zip\": \"60007\",\n \"phone\": \"1231231234\"\n },\n \"items\": [\n {\n \"sku\": \"GLD-5000-BLACK-S\",\n \"quantity\": 2\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"{{usa-api-domain}}/api/v2021/shipping/rates","description":"Get real-time shipping rate estimates for a given destination and list of items.
\nUse this endpoint to display available carriers, service levels, prices, and delivery estimates before placing an order.
\nRates are calculated based on:
\nDestination address (ZIP, country, region)
\nPackage weight and quantity (derived from the SKUs)
\nShipping carrier availability by region
\nPriority level: Standard, Priority, Express
\ncarrier: e.g., USPS, UPS, FedEx
service_level: e.g., Ground Advantage, 2-Day, Overnight
cost: calculated shipping charge
estimated_delivery_days: transit time in business days
rate_id: unique identifier used when submitting the order
Use the returned rate_id when submitting the actual order to lock in the rate
Refresh rates if the cart or address changes
\n