RESOURCE | Dielines

GET '/dieline-templates/{id}/dielines'

Get list of your custom dielines for a specific dieline template.

Request Parameters

id string	Unique identifier for the template. required For example: "becf-10319" Dieline template ids start with "becf". Available dieline templates are listed on https://www.diecuttemplates.com/dielines
page integer	The page number for paginated results. Default is 1
page_size integer	Number of dielines to return per page. Default is 100

Response Object

Returns "dieline_list" object.

Objects | dieline_list

type string

"dieline_list"

dieline_template_id string

Unique identifier for the dieline template.
Example: "becf-10301"

total integer

Total number of dielines in the list.
Example: 42

page integer

Example: 1

page_size integer

Example: 100

dielines [dieline]

List of "dielines".

Objects | dieline

type string

"dieline"

id string

Unique identifier for custom dieline
"di_fwe4iu3vngty"

dieline_template_id string

Unique identifier for the dieline template.
Example: "becf-10301"

variables object

Key-value pairs including values for "dieline template variables" that define the dimensions when the custom dieline was generated.

unit enum	Unit required Possible values are: "mm" "in"
material decimal	Material thickness. For example 1.23
{dieline_template_variable_name} string Dieline template specific dieline template variable names. For example a, b, top_tuck_flap	value for the {dieline_template_variable_name} For example 100.00

format string

File format. "dxf", "pdf" or "svg"

url URL

URL for the dieline. The custom dieline can be downloaded directly from this link.

artwork_dimensions width and height

This is the dimensions for uploading artwork to create a 3D Mockup. The image file doesn't need to be in this exact dimensions but it should have the same aspect ratio.

links [dieline_link]

created_at DateTime

For example: 2024-11-25T10:00:00Z

links [link]

Links providing a way to navigate between dieline_lists.

Code Examples


curl -i -X GET \
https://api.diecuttemplates.com/dieline-templates/becf-10301/dielines?page=2&page_size=50 \
  -H 'Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>' \
  -H 'Dielines-Api-Version: 1.0'


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

url = URI('https://api.diecuttemplates.com/dieline-templates/becf-10301/dielines?page=2&page_size=50')

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

request = Net::HTTP::Get.new(url)
request['Dielines-Api-Version'] = '1.0'
request['Authorization'] = 'Bearer <YOUR_DIELINES_API_KEY_HERE>'

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


$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <YOUR_DIELINES_API_KEY_HERE>",
    "Dielines-Api-Version: 1.0"
  ],
  CURLOPT_URL => "https://api.diecuttemplates.com/dieline-templates/becf-10301/dielines?page=2&page_size=50",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$error = curl_error($curl);

curl_close($curl);

if ($error) {
  echo "cURL Error #:" . $error;
} else {
  echo $response;
}

Response - 200

application/json

{
  "dieline_list": {
    "type": "dieline_list",
    "dieline_template_id": "becf-10301",
    "total": 5,
    "page": 2,
    "page_size": 2,
    "dielines": [
      {
        "type": "dieline",
        "id": "wglf0haqdbil",
        "dieline_template_id": "becf-10301",
        "variables": {
          "unit": "mm",
          "width": 103,
          "height": 253,
          "length": 251.14,
          "material": 2.22,
          "overflow": true
        },
        "format": "pdf",
        "url": "https://d2atdwxjx7uc4i.cloudfront.net/dielines-api-examples/4c963798-e0db-4dcc-9111-a68f145510a220241219-19018-4f1gqv.pdf",
        "artwork_dimensions": {
          "unit": "mm",
          "width": "723.06",
          "height": "502.44"
        },
        "created_at": "2024-12-19T15:49:08Z"
      },
      {
        "type": "dieline",
        "id": "rxzngrhepdjd",
        "dieline_template_id": "becf-10301",
        "variables": {
          "unit": "mm",
          "width": 102,
          "height": 253,
          "length": 251.14,
          "material": 2.22,
          "overflow": true
        },
        "format": "pdf",
        "url": "https://d2atdwxjx7uc4i.cloudfront.net/dielines-api-examples/2ff5c981-b72e-4ad9-a4c9-c13df92ddd2720241219-19018-bogqon.pdf",
        "artwork_dimensions": {
          "unit": "mm",
          "width": "723.06",
          "height": "502.44"
        },
        "created_at": "2024-12-19T15:48:48Z"
      }
    ]
  },
  "links": [
    {
      "rel": "self",
      "href": "/dielines/becf-10301?page=2&page_size=2",
      "method": "GET"
    },
    {
      "rel": "previous_page",
      "href": "/dielines/becf-10301?page=1&page_size=2",
      "method": "GET"
    }
  ]
}

Rest API Reference