Fetching Dieline Templates

Creating Custom Dielines

Creating 3D Mockups

Fetching Nesting Templates

Creating Nestings

This documentation page is intended for developers looking to integrate the Dielines API into their systems. If you have any questions, please get in touch.

Die Cut Templates provides a hosted API available via HTTPS.

Dielines API allows for generating custom dielines in PDF, DXF, and SVG formats, along with 3D mockups and nesting.

To create custom dieline using the dieline template (becf-21e28) via the API, please make a
POST request to https://api.diecuttemplates.com/dieline-templates/becf-21e28/dielines


Code Examples 



curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-21e28/dielines\
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
  -d '{
  "format": "pdf",
  "variables": {
    "unit": "in",
    "material": 1.1906,
    "length": 10.0,
    "width": 6.0,
    "height": 8.0
  }
}'


require 'uri'
require 'net/http'
require 'openssl'

url = URI('https://api.diecuttemplates.com/dieline-templates/becf-21e28/dielines')

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request['Content-Type'] = 'application/json'
request['Dielines-Api-Version'] = '1.0'
request['Authorization'] = 'Bearer <YOUR_DIELINES_API_KEY_HERE>'
params = {
  "format": "pdf",
  "variables": {
    "unit": "in",
    "material": 0.11,
    "length": 4.25,
    "width": 3.00,
    "height": 5.00,
    "top_tuck_flap": 0.53
  }
}

request.body = params.to_json

response = http.request(request)
puts response.read_body



$url = 'https://api.diecuttemplates.com/dieline-templates/becf-21e28/dielines';
$data = [
    "format" => "pdf",
    "variables" => [
      "unit" => "in",
      "material" => "1.1906",
      "length" => "10.0",
      "width" => "6.0",
      "height" => "8.0"
    ]
];

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>'
]);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Error: ' . curl_error($ch);
} else {
    echo 'Response: ' . $response;
}

curl_close($ch);

Example Response

application/json 
{
  "dieline": {
    "type": "dieline",
    "id": "di_ueipnpyp0rlw",
    "dieline_template_id": "becf-10301",
    "variables": {
      "unit": "mm",
      "length": 251.13,
      "width": 102,
      "height": 253,
      "material": 2.22,
      "dimension_texts": true
    },
    "format": "pdf",
    "url": "https://d2atdwxjx7uc4i.cloudfront.net/campaigns/0e9d742f-bdcd-4b41-8122-88e0426d263f20241218-14172-y29ocn.pdf",
    "artwork_dimensions": {
      "unit": "mm",
      "width": "723.06",
      "height": "502.44"
    },
    "area": {
      "unit": "mm2",
      "value": "11723.06"
    },
    "links": [
      {
        "rel": "create_3d_mockup",
        "href": "/dielines/di_ueipnpyp0rlw/3d-mockups",
        "method": "POST"
      }
    ],
    "created_at": "2024-12-18T19:27:22Z"
  }
}


List of variables that are available for the template

Variable name material required
Description Material thickness
Data type length
Default value 0.0469 in
Variable name dimension_type optional
Description
Data type string
Default value external
Allowed values external, internal
Variable name length required
Description length
Data type length
Default value 9.8425 in
Variable name width required
Description width
Data type length
Default value 5.9055 in
Variable name height required
Description height
Data type length
Default value 7.874 in
Variable name direction optional
Description direction
Data type boolean
Default value false
Allowed values true, false, 0, 1
Variable name cross optional
Description cross
Data type boolean
Default value false
Allowed values true, false, 0, 1
Variable name hand_holding_margin optional
Description hand holding margin
Data type length
Default value 1.18 in
Variable name hand_holding_length optional
Description hand holding length
Data type length
Default value 3.543 in
Variable name hand_holding_width optional
Description hand holding width
Data type length
Default value 0.985 in
Variable name hand_holding_area optional
Description hand holding area
Data type length
Default value 2.756 in
Variable name lock_area optional
Description lock area
Data type length
Default value 1.378 in
Variable name lock_width optional
Description lock width
Data type length
Default value 0.689 in
Variable name glue_flap optional
Description glue flap
Data type length
Default value 1.2 in
Variable name bottom_tuck_flap optional
Description bottom tuck flap
Data type length
Default value 1.0 in
Variable name printing_method optional
Description Offset (material is squeezed) or Flexo (material is not squeezed)
Data type string
Default value offset
Allowed values offset, flexo


Read Dielines API documentation

dielines Die Cut Templates is an online packaging template collection, custom dieline generator, template maker and a packaging design tool with nesting, manufacturing cost calculator and 3D capabilities. All of the packaging templates are easy to download. We have over 35,000 vector packaging templates (dielines) for tuck end boxes, snap lock boxes, tuck top auto bottom boxes, standard boxes, four corner tray boxes, fruit and vegetable boxes, special boxes, separators, paper bags, gift boxes and a great number of packaging templates. With Die Cut Templates, you can arrange your dielines using the nesting tool. Die Cut Templates also offers uploading your logos and artwork for your 3d Mockup designs and offers online previews in 3D. Die Cut Templates also provide a Dielines API. Dielines API allows for generating custom dielines in PDF, DXF, and SVG formats, along with 3D mockups and nesting.

Contact us