Cartons | Food Boxes | becf-12017
3D Mockup

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.

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


Code Examples



curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-12017/dielines\
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
  -d '{
  "format": "pdf",
  "variables": {
    "unit": "in",
    "material": 0.4826,
    "bottom_length": "5.9",
    "bottom_width": "3.937",
    "height": "1.9685"
  }
}'

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

url = URI('https://api.diecuttemplates.com/dieline-templates/becf-12017/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-12017/dielines';
$data = [
    "format" => "pdf",
    "variables" => [
      "unit" => "in",
      "material" => "0.4826",
      "bottom_length" => "5.9",
      "bottom_width" => "3.937",
      "height" => "1.9685"
    ]
];

$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": "ueipnpyp0rlw",
    "dieline_template_id": "becf-10301",
    "variables": {
      "unit": "mm",
      "length": 251.13,
      "width": 102,
      "height": 253,
      "material": 2.22
    },
    "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"
    },
    "created_at": "2024-12-18T19:27:22Z"
  }
} 



List of variables that are available for the template

Variable name bottom_length required
Description bottom length
Data type length

Variable name bottom_width required
Description bottom width
Data type length

Variable name height required
Description height
Data type length

Variable name top_length optional
Description top length
Data type length
Default value 6.693 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 dust_flap optional
Description dust flap
Data type length
Default value 1.18 in

Variable name dust_flap_slope_1 optional
Description dust flap slope
Data type length
Default value 0.59 in

Variable name dust_flap_slope_2 optional
Description dust flap slope
Data type length
Default value 0.59 in

Variable name lock optional
Description lock
Data type length
Default value 0.59 in

Variable name corner_radius optional
Description corner radius
Data type length
Default value 0.118 in

Variable name dust_flap_slope_3 optional
Description dust flap slope
Data type length
Default value 0.8 in

Variable name dust_flap_slope_4 optional
Description dust flap slope
Data type length
Default value 0.8 in

Variable name lock_flap optional
Description lock flap
Data type length
Default value 0.985 in

Variable name dust_flap_slope_5 optional
Description dust flap slope
Data type length
Default value 0.8 in

Variable name dust_flap_slope_6 optional
Description dust flap slope
Data type length
Default value 1.85 in



Read Dielines API documentation