Home

Introduction

Load Calculator API

version 2

Load Calculator is an application intended to compute and to place some goods into container and make their position to place some goods into a transport unit and make their position optimal. The software visualizes calculation and allows you to export results.

OpenAPI Specification

Start designing your API in minutes. The OpenAPI specification file enables you to learn and interact with API elements, including all available endpoints, input and output representations.

General information

Load Calculator API is organized around REST.
Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

API endpoint#

1https://www.searates.com

All endpoints are only accessible via HTTPS and are located at www.searates.com

Get packing result

post/stuffing/api
Headers

Content-Typeapplication/json

Query Parameters
  • keyOptionalstring

    Your API key (Must be filled if "Authorization" header is missing)

Body Parameters
  • optionsREQUIREDobject
  • groupsREQUIREDarray[object]

    Groups are an array of JSON objects arranged in a strict order, which is taken into account when stuffing containers. The closer to the beginning of the array the group, the earlier it will be stuffed. A group can contain a pallet setting for a group.

  • containersOptionalarray[object]

    fixed quantity of containers that fill up earlier than auto containers

  • autoContainersREQUIREDarray[object]

    The algorithm determines which type will be used for loading automatically.

  • imagesOptionalobject
Request sample
{
  "options": {
    "lengthUnits": "mm",
    "weightUnits": "kg",
    "lengthAccuracy": 5,
    "remainsNear": true
  },
  "groups": [
    {
      "name": "Group #1",
      "uid": 111,
      "color": "#000",
      "pallets": {
        "uid": "1dca98",
        "color": "#000",
        "size": {
          "length": 1200,
          "width": 800,
          "height": 2000
        },
        "stacking": {
          "maxHeight": null,
          "layers": 3,
          "fill": 0.85
        },
        "weight": 10,
        "maxWeight": 1500,
        "depth": 100,
        "name": "euro",
        "type": "euro"
      },
      "items": [
        {
          "color": "#23b753",
          "index": 1,
          "name": "Boxes 1",
          "qty": "400",
          "type": "box",
          "uid": "2222",
          "weight": 10,
          "size": {
            "length": 500,
            "width": 400,
            "height": 300,
            "radius": null
          },
          "stacking": {
            "tiltX": true,
            "tiltY": false,
            "layers": null,
            "topWeight": null,
            "height": null,
            "fill": null,
            "rollPlacement": null
          }
        }
      ]
    }
  ],
  "containers": [],
  "autoContainers": [
    {
      "attr": {
        "type": "20st"
      },
      "spaces": [
        {
          "length": 5890,
          "width": 2350,
          "height": 2390,
          "maxWeight": 28230
        }
      ]
    },
    {
      "attr": {
        "type": "40st"
      },
      "spaces": [
        {
          "length": 12020,
          "width": 2350,
          "height": 2390,
          "maxWeight": 26700
        }
      ]
    },
    {
      "attr": {
        "type": "40hq"
      },
      "spaces": [
        {
          "length": 12020,
          "width": 2350,
          "height": 2690,
          "maxWeight": 26460
        }
      ]
    }
  ],
  "auth": {
    "demo": false,
    "user": false
  },
  "errorProducts": [],
  "palletCheckLoader": false
}
Response example
Successful operation
1{
2  "result": [
3    {
4      "qty": 1,
5      "spaces": [
6        {
7          "general": {
8            "itemQty": 32,
9            "cargoVolume": 1920000000,
10            "cargoWeight": 320,
11            "items": {
12              "2222": 32
13            },
14            "volumeRatio": 1,
15            "weightRatio": 0.21333333333333335
16          },
17          "floorBox": {
18            "x": 800,
19            "y": 1200,
20            "z": 100
21          },
22          "children": [
23            {
24              "general": {
25                "itemQty": 32,
26                "cargoVolume": 1920000000,
27                "cargoWeight": 320,
28                "items": {
29                  "2222": 32
30                }
31              },
32              "children": null,
33              "form": "box",
34              "uid": "2222",
35              "color": "#23b753",
36              "name": "Boxes 1",
37              "size": {
38                "x": 400,
39                "y": 300,
40                "z": 500
41              },
42              "complex": {
43                "x": 2,
44                "y": 4,
45                "z": 4
46              },
47              "location": {
48                "x": 0,
49                "y": 0,
50                "z": 0
51              }
52            }
53          ],
54          "form": "box",
55          "uid": "8523d727-89d9-4733-a739-8c9444749377",
56          "color": null,
57          "name": null,
58          "size": {
59            "x": 800,
60            "y": 1200,
61            "z": 2100
62          },
63          "complex": {
64            "x": 1,
65            "y": 1,
66            "z": 1
67          },
68          "location": {
69            "x": 0,
70            "y": 0,
71            "z": 0
72          }
73        },
74        {
75          "general": {
76            "itemQty": 32,
77            "cargoVolume": 1920000000,
78            "cargoWeight": 320,
79            "items": {
80              "2222": 32
81            },
82            "volumeRatio": 1,
83            "weightRatio": 0.21333333333333335
84          },
85          "floorBox": {
86            "x": 800,
87            "y": 1200,
88            "z": 100
89          },
90          "children": [
91            {
92              "general": {
93                "itemQty": 32,
94                "cargoVolume": 1920000000,
95                "cargoWeight": 320,
96                "items": {
97                  "2222": 32
98                }
99              },
100              "children": null,
101              "form": "box",
102              "uid": "2222",
103              "color": "#23b753",
104              "name": "Boxes 1",
105              "size": {
106                "x": 400,
107                "y": 300,
108                "z": 500
109              },
110              "complex": {
111                "x": 2,
112                "y": 4,
113                "z": 4
114              },
115              "location": {
116                "x": 0,
117                "y": 0,
118                "z": 0
119              }
120            }
121          ],
122          "form": "box",
123          "uid": "ca7b1ad0-84ac-40e2-9233-49415c07763e",
124          "color": null,
125          "name": null,
126          "size": {
127            "x": 800,
128            "y": 1200,
129            "z": 2100
130          },
131          "complex": {
132            "x": 1,
133            "y": 1,
134            "z": 1
135          },
136          "location": {
137            "x": 800,
138            "y": 0,
139            "z": 0
140          }
141        },
142        {
143          "general": {
144            "itemQty": 32,
145            "cargoVolume": 1920000000,
146            "cargoWeight": 320,
147            "items": {
148              "2222": 32
149            },
150            "volumeRatio": 1,
151            "weightRatio": 0.21333333333333335
152          },
153          "floorBox": {
154            "x": 800,
155            "y": 1200,
156            "z": 100
157          },
158          "children": [
159            {
160              "general": {
161                "itemQty": 32,
162                "cargoVolume": 1920000000,
163                "cargoWeight": 320,
164                "items": {
165                  "2222": 32
166                }
167              },
168              "children": null,
169              "form": "box",
170              "uid": "2222",
171              "color": "#23b753",
172              "name": "Boxes 1",
173              "size": {
174                "x": 400,
175                "y": 300,
176                "z": 500
177              },
178              "complex": {
179                "x": 2,
180                "y": 4,
181                "z": 4
182              },
183              "location": {
184                "x": 0,
185                "y": 0,
186                "z": 0
187              }
188            }
189          ],
190          "form": "box",
191          "uid": "2a5252ca-a9a5-4075-9a8a-06e6f2a065f7",
192          "color": null,
193          "name": null,
194          "size": {
195            "x": 800,
196            "y": 1200,
197            "z": 2100
198          },
199          "complex": {
200            "x": 1,
201            "y": 1,
202            "z": 1
203          },
204          "location": {
205            "x": 1600,
206            "y": 0,
207            "z": 0
208          }
209        },
210        {
211          "general": {
212            "itemQty": 32,
213            "cargoVolume": 1920000000,
214            "cargoWeight": 320,
215            "items": {
216              "2222": 32
217            },
218            "volumeRatio": 1,
219            "weightRatio": 0.21333333333333335
220          },
221          "floorBox": {
222            "x": 800,
223            "y": 1200,
224            "z": 100
225          },
226          "children": [
227            {
228              "general": {
229                "itemQty": 32,
230                "cargoVolume": 1920000000,
231                "cargoWeight": 320,
232                "items": {
233                  "2222": 32
234                }
235              },
236              "children": null,
237              "form": "box",
238              "uid": "2222",
239              "color": "#23b753",
240              "name": "Boxes 1",
241              "size": {
242                "x": 400,
243                "y": 300,
244                "z": 500
245              },
246              "complex": {
247                "x": 2,
248                "y": 4,
249                "z": 4
250              },
251              "location": {
252                "x": 0,
253                "y": 0,
254                "z": 0
255              }
256            }
257          ],
258          "form": "box",
259          "uid": "3da21465-7881-45cb-800f-e6223eea4f2d",
260          "color": null,
261          "name": null,
262          "size": {
263            "x": 800,
264            "y": 1200,
265            "z": 2100
266          },
267          "complex": {
268            "x": 1,
269            "y": 1,
270            "z": 1
271          },
272          "location": {
273            "x": 2400,
274            "y": 0,
275            "z": 0
276          }
277        },
278        {
279          "general": {
280            "itemQty": 32,
281            "cargoVolume": 1920000000,
282            "cargoWeight": 320,
283            "items": {
284              "2222": 32
285            },
286            "volumeRatio": 1,
287            "weightRatio": 0.21333333333333335
288          },
289          "floorBox": {
290            "x": 800,
291            "y": 1200,
292            "z": 100
293          },
294          "children": [
295            {
296              "general": {
297                "itemQty": 32,
298                "cargoVolume": 1920000000,
299                "cargoWeight": 320,
300                "items": {
301                  "2222": 32
302                }
303              },
304              "children": null,
305              "form": "box",
306              "uid": "2222",
307              "color": "#23b753",
308              "name": "Boxes 1",
309              "size": {
310                "x": 400,
311                "y": 300,
312                "z": 500
313              },
314              "complex": {
315                "x": 2,
316                "y": 4,
317                "z": 4
318              },
319              "location": {
320                "x": 0,
321                "y": 0,
322                "z": 0
323              }
324            }
325          ],
326          "form": "box",
327          "uid": "a95971ca-913b-4548-bf1e-63215a5233d9",
328          "color": null,
329          "name": null,
330          "size": {
331            "x": 800,
332            "y": 1200,
333            "z": 2100
334          },
335          "complex": {
336            "x": 1,
337            "y": 1,
338            "z": 1
339          },
340          "location": {
341            "x": 3200,
342            "y": 0,
343            "z": 0
344          }
345        },
346        {
347          "general": {
348            "itemQty": 32,
349            "cargoVolume": 1920000000,
350            "cargoWeight": 320,
351            "items": {
352              "2222": 32
353            },
354            "volumeRatio": 1,
355            "weightRatio": 0.21333333333333335
356          },
357          "floorBox": {
358            "x": 800,
359            "y": 1200,
360            "z": 100
361          },
362          "children": [
363            {
364              "general": {
365                "itemQty": 32,
366                "cargoVolume": 1920000000,
367                "cargoWeight": 320,
368                "items": {
369                  "2222": 32
370                }
371              },
372              "children": null,
373              "form": "box",
374              "uid": "2222",
375              "color": "#23b753",
376              "name": "Boxes 1",
377              "size": {
378                "x": 400,
379                "y": 300,
380                "z": 500
381              },
382              "complex": {
383                "x": 2,
384                "y": 4,
385                "z": 4
386              },
387              "location": {
388                "x": 0,
389                "y": 0,
390                "z": 0
391              }
392            }
393          ],
394          "form": "box",
395          "uid": "481bb82e-6fd7-4d18-b715-e7deb0bee191",
396          "color": null,
397          "name": null,
398          "size": {
399            "x": 800,
400            "y": 1200,
401            "z": 2100
402          },
403          "complex": {
404            "x": 1,
405            "y": 1,
406            "z": 1
407          },
408          "location": {
409            "x": 4000,
410            "y": 0,
411            "z": 0
412          }
413        },
414        {
415          "general": {
416            "itemQty": 32,
417            "cargoVolume": 1920000000,
418            "cargoWeight": 320,
419            "items": {
420              "2222": 32
421            },
422            "volumeRatio": 1,
423            "weightRatio": 0.21333333333333335
424          },
425          "floorBox": {
426            "x": 800,
427            "y": 1200,
428            "z": 100
429          },
430          "children": [
431            {
432              "general": {
433                "itemQty": 32,
434                "cargoVolume": 1920000000,
435                "cargoWeight": 320,
436                "items": {
437                  "2222": 32
438                }
439              },
440              "children": null,
441              "form": "box",
442              "uid": "2222",
443              "color": "#23b753",
444              "name": "Boxes 1",
445              "size": {
446                "x": 400,
447                "y": 300,
448                "z": 500
449              },
450              "complex": {
451                "x": 2,
452                "y": 4,
453                "z": 4
454              },
455              "location": {
456                "x": 0,
457                "y": 0,
458                "z": 0
459              }
460            }
461          ],
462          "form": "box",
463          "uid": "99b404cc-68c8-4689-a680-ae2a149a96c8",
464          "color": null,
465          "name": null,
466          "size": {
467            "x": 800,
468            "y": 1200,
469            "z": 2100
470          },
471          "complex": {
472            "x": 1,
473            "y": 1,
474            "z": 1
475          },
476          "location": {
477            "x": 4800,
478            "y": 0,
479            "z": 0
480          }
481        },
482        {
483          "general": {
484            "itemQty": 32,
485            "cargoVolume": 1920000000,
486            "cargoWeight": 320,
487            "items": {
488              "2222": 32
489            },
490            "volumeRatio": 1,
491            "weightRatio": 0.21333333333333335
492          },
493          "floorBox": {
494            "x": 1200,
495            "y": 800,
496            "z": 100
497          },
498          "children": [
499            {
500              "general": {
501                "itemQty": 32,
502                "cargoVolume": 1920000000,
503                "cargoWeight": 320,
504                "items": {
505                  "2222": 32
506                }
507              },
508              "children": null,
509              "form": "box",
510              "uid": "2222",
511              "color": "#23b753",
512              "name": "Boxes 1",
513              "size": {
514                "x": 300,
515                "y": 400,
516                "z": 500
517              },
518              "complex": {
519                "x": 4,
520                "y": 2,
521                "z": 4
522              },
523              "location": {
524                "x": 0,
525                "y": 0,
526                "z": 0
527              }
528            }
529          ],
530          "form": "box",
531          "uid": "73696560-9d1a-45e5-b7ab-f5c3643784e6",
532          "color": null,
533          "name": null,
534          "size": {
535            "x": 1200,
536            "y": 800,
537            "z": 2100
538          },
539          "complex": {
540            "x": 1,
541            "y": 1,
542            "z": 1
543          },
544          "location": {
545            "x": 0,
546            "y": 1200,
547            "z": 0
548          }
549        },
550        {
551          "general": {
552            "itemQty": 32,
553            "cargoVolume": 1920000000,
554            "cargoWeight": 320,
555            "items": {
556              "2222": 32
557            },
558            "volumeRatio": 1,
559            "weightRatio": 0.21333333333333335
560          },
561          "floorBox": {
562            "x": 1200,
563            "y": 800,
564            "z": 100
565          },
566          "children": [
567            {
568              "general": {
569                "itemQty": 32,
570                "cargoVolume": 1920000000,
571                "cargoWeight": 320,
572                "items": {
573                  "2222": 32
574                }
575              },
576              "children": null,
577              "form": "box",
578              "uid": "2222",
579              "color": "#23b753",
580              "name": "Boxes 1",
581              "size": {
582                "x": 300,
583                "y": 400,
584                "z": 500
585              },
586              "complex": {
587                "x": 4,
588                "y": 2,
589                "z": 4
590              },
591              "location": {
592                "x": 0,
593                "y": 0,
594                "z": 0
595              }
596            }
597          ],
598          "form": "box",
599          "uid": "b77ef764-995e-4409-8c7a-fb8fc144fe4e",
600          "color": null,
601          "name": null,
602          "size": {
603            "x": 1200,
604            "y": 800,
605            "z": 2100
606          },
607          "complex": {
608            "x": 1,
609            "y": 1,
610            "z": 1
611          },
612          "location": {
613            "x": 1200,
614            "y": 1200,
615            "z": 0
616          }
617        },
618        {
619          "general": {
620            "itemQty": 32,
621            "cargoVolume": 1920000000,
622            "cargoWeight": 320,
623            "items": {
624              "2222": 32
625            },
626            "volumeRatio": 1,
627            "weightRatio": 0.21333333333333335
628          },
629          "floorBox": {
630            "x": 1200,
631            "y": 800,
632            "z": 100
633          },
634          "children": [
635            {
636              "general": {
637                "itemQty": 32,
638                "cargoVolume": 1920000000,
639                "cargoWeight": 320,
640                "items": {
641                  "2222": 32
642                }
643              },
644              "children": null,
645              "form": "box",
646              "uid": "2222",
647              "color": "#23b753",
648              "name": "Boxes 1",
649              "size": {
650                "x": 300,
651                "y": 400,
652                "z": 500
653              },
654              "complex": {
655                "x": 4,
656                "y": 2,
657                "z": 4
658              },
659              "location": {
660                "x": 0,
661                "y": 0,
662                "z": 0
663              }
664            }
665          ],
666          "form": "box",
667          "uid": "05d49ea6-e6f5-4b5a-b399-ca8850f0c78a",
668          "color": null,
669          "name": null,
670          "size": {
671            "x": 1200,
672            "y": 800,
673            "z": 2100
674          },
675          "complex": {
676            "x": 1,
677            "y": 1,
678            "z": 1
679          },
680          "location": {
681            "x": 2400,
682            "y": 1200,
683            "z": 0
684          }
685        },
686        {
687          "general": {
688            "itemQty": 32,
689            "cargoVolume": 1920000000,
690            "cargoWeight": 320,
691            "items": {
692              "2222": 32
693            },
694            "volumeRatio": 1,
695            "weightRatio": 0.21333333333333335
696          },
697          "floorBox": {
698            "x": 1200,
699            "y": 800,
700            "z": 100
701          },
702          "children": [
703            {
704              "general": {
705                "itemQty": 32,
706                "cargoVolume": 1920000000,
707                "cargoWeight": 320,
708                "items": {
709                  "2222": 32
710                }
711              },
712              "children": null,
713              "form": "box",
714              "uid": "2222",
715              "color": "#23b753",
716              "name": "Boxes 1",
717              "size": {
718                "x": 300,
719                "y": 400,
720                "z": 500
721              },
722              "complex": {
723                "x": 4,
724                "y": 2,
725                "z": 4
726              },
727              "location": {
728                "x": 0,
729                "y": 0,
730                "z": 0
731              }
732            }
733          ],
734          "form": "box",
735          "uid": "7d6a00b7-397f-45f5-bce4-91b59e4befac",
736          "color": null,
737          "name": null,
738          "size": {
739            "x": 1200,
740            "y": 800,
741            "z": 2100
742          },
743          "complex": {
744            "x": 1,
745            "y": 1,
746            "z": 1
747          },
748          "location": {
749            "x": 3600,
750            "y": 1200,
751            "z": 0
752          }
753        }
754      ],
755      "attr": {
756        "type": "20st",
757        "volume": 33081185000,
758        "maxWeight": 28230
759      },
760      "general": {
761        "itemQty": 352,
762        "cargoVolume": 21120000000,
763        "cargoWeight": 3520,
764        "items": {
765          "2222": 352
766        },
767        "volumeRatio": 0.6384293670253952,
768        "weightRatio": 0.1246900460503011
769      },
770      "uid": "ad25045b-7eb2-4e23-ab78-ae5088826a14",
771      "size": {
772        "x": 5890,
773        "y": 2350,
774        "z": 2390
775      }
776    },
777    {
778      "qty": 1,
779      "spaces": [
780        {
781          "general": {
782            "itemQty": 32,
783            "cargoVolume": 1920000000,
784            "cargoWeight": 320,
785            "items": {
786              "2222": 32
787            },
788            "volumeRatio": 1,
789            "weightRatio": 0.21333333333333335
790          },
791          "floorBox": {
792            "x": 800,
793            "y": 1200,
794            "z": 100
795          },
796          "children": [
797            {
798              "general": {
799                "itemQty": 32,
800                "cargoVolume": 1920000000,
801                "cargoWeight": 320,
802                "items": {
803                  "2222": 32
804                }
805              },
806              "children": null,
807              "form": "box",
808              "uid": "2222",
809              "color": "#23b753",
810              "name": "Boxes 1",
811              "size": {
812                "x": 400,
813                "y": 300,
814                "z": 500
815              },
816              "complex": {
817                "x": 2,
818                "y": 4,
819                "z": 4
820              },
821              "location": {
822                "x": 0,
823                "y": 0,
824                "z": 0
825              }
826            }
827          ],
828          "form": "box",
829          "uid": "ccad3167-b515-4031-ae3c-4db8b80220f3",
830          "color": null,
831          "name": null,
832          "size": {
833            "x": 800,
834            "y": 1200,
835            "z": 2100
836          },
837          "complex": {
838            "x": 1,
839            "y": 1,
840            "z": 1
841          },
842          "location": {
843            "x": 0,
844            "y": 0,
845            "z": 0
846          }
847        },
848        {
849          "general": {
850            "itemQty": 16,
851            "cargoVolume": 960000000,
852            "cargoWeight": 160,
853            "items": {
854              "2222": 16
855            },
856            "volumeRatio": 0.5,
857            "weightRatio": 0.10666666666666667
858          },
859          "floorBox": {
860            "x": 800,
861            "y": 1200,
862            "z": 100
863          },
864          "children": [
865            {
866              "general": {
867                "itemQty": 16,
868                "cargoVolume": 960000000,
869                "cargoWeight": 160,
870                "items": {
871                  "2222": 16
872                }
873              },
874              "children": null,
875              "form": "box",
876              "uid": "2222",
877              "color": "#23b753",
878              "name": "Boxes 1",
879              "size": {
880                "x": 400,
881                "y": 300,
882                "z": 500
883              },
884              "complex": {
885                "x": 2,
886                "y": 4,
887                "z": 2
888              },
889              "location": {
890                "x": 0,
891                "y": 0,
892                "z": 0
893              }
894            }
895          ],
896          "form": "box",
897          "uid": "c2d0ce90-4e33-4a3e-bfcb-b253111d92f1",
898          "color": null,
899          "name": null,
900          "size": {
901            "x": 800,
902            "y": 1200,
903            "z": 2100
904          },
905          "complex": {
906            "x": 1,
907            "y": 1,
908            "z": 1
909          },
910          "location": {
911            "x": 800,
912            "y": 0,
913            "z": 0
914          }
915        }
916      ],
917      "attr": {
918        "type": "20st",
919        "volume": 33081185000,
920        "maxWeight": 28230
921      },
922      "general": {
923        "itemQty": 48,
924        "cargoVolume": 2880000000,
925        "cargoWeight": 480,
926        "items": {
927          "2222": 48
928        },
929        "volumeRatio": 0.08705855004891754,
930        "weightRatio": 0.01700318809776833
931      },
932      "uid": "4752d58a-2f7f-436f-8381-559b4f8d28bc",
933      "size": {
934        "x": 5890,
935        "y": 2350,
936        "z": 2390
937      }
938    }
939  ],
940  "cargoAttributes": {
941    "2222": {
942      "name": "Boxes 1",
943      "color": "#23b753",
944      "volume": 60000000,
945      "weight": 10,
946      "type": "box"
947    }
948  },
949  "version": "02.0.12"
950}