LUlulu
Print-Jobs

Retrieve a list of Print-Jobs

Changed on

Use this request to show a list of Print-Jobs. The list is paginated and can be filtered by various attributes that are given as query parameters.

Timestamps like created_after, created_before, modified_after, and modified_before can be entered as ISO8601 datetime strings.

Internally, the Lulu API uses Coordinated Universal Time (UTC). The following formats are valid:

  • 2017-11-09 (date only)
  • 2017-11-09T09:30 (datetime with minute precision)
  • 2017-11-09T09:30:08 (datetime with second precision)
  • 2017-11-09T09:30:08Z (UTC datetime)
  • 2017-11-09T09:30:08+06:00 (datetime with offset)

To filter Print-Jobs by status you can use any valid status string (CREATED, REJECTED, UNPAID, PAYMENT_IN_PROGRESS, PRODUCTION_READY, PRODUCTION_DELAYED, IN_PRODUCTION, ERROR, SHIPPED, CANCELED). PAYMENT_IN_PROGRESS and PRODUCTION_READY are rather short-lived states that exist only for a few minutes at max; filtering by these status will rarely yield any results.

get/print-jobs/

Request

Query parameters

pageinteger

Result page, default: 1

page_sizeinteger

The default is 100.

created_afterstring

Filter by creation timestamp after the given (ISO 8601) timestamp.

created_beforestring

Filter by creation timestamp before the given (ISO 8601) timestamp.

modified_afterstring

Filter by modification timestamp after the given (ISO 8601) timestamp.

modified_beforestring

Filter by modification timestamp before the given (ISO 8601) timestamp.

statusstring

Filter by status

idstring

Filter by id

order_idstring

Filter by order_id

exclude_line_itemsboolean

Leave the list of line_items out of the Print-Jobs in the response.

searchstring

Search across the fields id, external_id, order_id, status, line_item_id, line_item_external_id, line_item_title, line_item_tracking_id and shipping_address

orderingstring

Which field to use when ordering the results.

Response

OK

countinteger
nextstring
previousstring

Example response

{
  "count": 1,
  "next": "https://api.lulu.com/resources/?page=1&page_size=1",
  "previous": "https://api.lulu.com/resources/?page=1&page_size=1",
  "results": [
    {
      "contact_email": "test@test.com",
      "costs": {
        "line_item_costs": null,
        "shipping_cost": {
          "total_cost_excl_tax": "132.74",
          "total_cost_incl_tax": "132.74",
          "total_tax": "0.00",
          "tax_rate": "0.000000"
        },
        "fulfillment_cost": {
          "total_cost_excl_tax": "0.75",
          "total_cost_incl_tax": "0.81",
          "total_tax": "0.06",
          "tax_rate": "0.080000"
        },
        "fees": [
          {
            "currency": "USD",
            "fee_type": "HANDLING_FEE",
            "sku": "HANDLING_FEE_6",
            "tax_rate": "0.088750",
            "total_cost_excl_tax": "4.00",
            "total_cost_incl_tax": "4.36",
            "total_tax": "0.36"
          }
        ],
        "total_cost_excl_tax": null,
        "total_cost_incl_tax": null,
        "total_tax": null
      },
      "date_created": "2017-08-07T08:47:26.485456Z",
      "date_modified": "2017-08-07T08:47:26.485490Z",
      "estimated_shipping_dates": {
        "arrival_max": "2017-08-12",
        "arrival_min": "2017-08-10",
        "dispatch_max": "2017-08-09",
        "dispatch_min": "2017-08-07"
      },
      "external_id": "demo-time",
      "id": 1,
      "line_items": [
        {
          "external_id": "item-reference-1",
          "id": 1,
          "printable_id": null,
          "printable_normalization": {
            "cover": {
              "job_id": null,
              "normalized_file": null,
              "page_count": null,
              "source_file": null,
              "source_md5sum": "e78512c777e7f5841fe8f1992cefb898",
              "source_url": "https://www.dropbox.com/sh/p3zh22vzsaegiri/AADP367j0bTWlt8fCu-_tm2ia/161025/139056_cover.pdf?dl=1"
            },
            "interior": {
              "job_id": null,
              "normalized_file": null,
              "page_count": null,
              "source_file": null,
              "source_md5sum": "7f8af20c296747689756f8e310135d79",
              "source_url": "https://www.dropbox.com/sh/p3zh22vzsaegiri/AACOUn3LFKsITDzylh13bQpsa/161025/thesis2.pdf?dl=1"
            },
            "pod_package_id": "0600X0900.BW.STD.PB.060UW444.MXX"
          },
          "quantity": 20,
          "status": {
            "messages": {
              "info": "Line-item is currently being validated"
            },
            "name": "CREATED"
          },
          "title": "My Book"
        }
      ],
      "production_delay": 120,
      "production_due_time": null,
      "shipping_address": {
        "city": "Lübeck",
        "country_code": "DE",
        "is_business": false,
        "name": "Hans Dampf",
        "phone_number": "844-212-0689",
        "postcode": "23552",
        "state_code": "",
        "street1": "Holstenstr. 40",
        "street2": "",
        "warnings": {
          "type": "validation_warning",
          "path": "external",
          "code": "REPLACED",
          "message": "street1: Holstenstr. 40 -> Holstenstraße 40"
        },
        "suggested_address": {
          "country_code": "DE",
          "state_code": null,
          "postcode": 23552,
          "city": "Lübeck",
          "street1": "Holstenstraße 40\"",
          "street2": null
        }
      },
      "shipping_level": "MAIL",
      "shipping_option_level": "MAIL",
      "status": {
        "changed": "2017-08-07T08:47:26.480493Z",
        "message": "Print-job is currently being validated",
        "name": "CREATED"
      }
    }
  ]
}

Changes

  • 3119f71811f8Revision changes
    • breaking

      the //// response property's maxLength was increased from 27 to 100 for the response status

    • warning

      removed the optional property ////// from the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

  • 692a2290ef22Revision changes
    • info

      endpoint added