Cartons | Special Boxes | becf-11e18
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-11e18) via the API, please make a
POST request to https://api.diecuttemplates.com/dieline-templates/becf-11e18/dielines


Code Examples



curl -i -X POST \
https://api.diecuttemplates.com/dieline-templates/becf-11e18/dielines\
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>" \
  -d '{
  "format": "pdf",
  "variables": {
    "unit": "in",
    "material": 0.4826,
    "length": "5.5",
    "front_height": "3.94",
    "front_flap": "2.37",
    "back_height": "2.37",
    "back_flap": "1.38",
    "front_width": "0.59",
    "back_width": "0.4"
  }
}'

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

url = URI('https://api.diecuttemplates.com/dieline-templates/becf-11e18/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-11e18/dielines';
$data = [
    "format" => "pdf",
    "variables" => [
      "unit" => "in",
      "material" => "0.4826",
      "length" => "5.5",
      "front_height" => "3.94",
      "front_flap" => "2.37",
      "back_height" => "2.37",
      "back_flap" => "1.38",
      "front_width" => "0.59",
      "back_width" => "0.4"
    ]
];

$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"
    },
    "created_at": "2024-12-18T19:27:22Z"
  }
} 



List of variables that are available for the template

Variable name length required
Description length
Data type length

Variable name front_height required
Description front height
Data type length

Variable name front_flap required
Description front flap
Data type length

Variable name back_height required
Description back height
Data type length

Variable name back_flap required
Description back flap
Data type length

Variable name front_width required
Description front width
Data type length

Variable name back_width required
Description back width
Data type length

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 banner_flap optional
Description banner flap
Data type length
Default value 0.985 in

Variable name hanger_length optional
Description hanger length
Data type length
Default value 1.969 in

Variable name dimension_texts optional
Description
Data type boolean
Default value true
Allowed values true, false



Read Dielines API documentation