--- title: "Retrieve a list of Print-Jobs" method: GET path: "/print-jobs/" tags: ["Print-Jobs"] --- # Retrieve a list of Print-Jobs `GET /print-jobs/` 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](https://www.w3.org/TR/NOTE-datetime). Internally, the Lulu API uses [Coordinated Universal Time (UTC)](https://en.wikipedia.org/wiki/Coordinated_Universal_Time). 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. ## Query parameters - `page` integer - `page_size` integer - `created_after` string - `created_before` string - `modified_after` string - `modified_before` string - `status` string - `id` string - `order_id` string - `exclude_line_items` boolean - `search` string - `ordering` string ## Response `200` OK - object - `count` integer - `next` string - `previous` string - `results` object[] - `contact_email` string, email, required — Email address that should be contacted if questions regarding the Print-Job arise. Lulu recommends to use the email of a person who is responsible for placing the Print-Job like a developer or business owner. - `costs` object — Summary of the costs of a Print-Job - `line_item_costs` object — Costs for a Print-Job line item - `cost_excl_discounts` string, required — Per unit cost without any discounts applied as a decimal string - `discounts` object[], required — Discounts applied to this line item - `amount` string, required — The deducted amount as a decimal string - `description` string, required — Description of the discount - `quantity` number, required — The quantity of printables to base the calculations on - `tax_rate` string, required — The tax rate applied to the line as a decimal string - `total_cost_excl_discounts` string, required — The total line price without any discounts applied as a decimal string - `total_cost_excl_tax` string, required — The total line price including discounts excluding tax as a decimal string - `total_cost_incl_tax` string, required — The total line price including discounts and taxes as a decimal string - `total_tax` string, required — The total line tax amount as a decimal string - `unit_tier_cost` string — Per unit cost with tier discount applied, null for list price (non-tier) customers - `currency` string — Currency for the costs - `shipping_cost` object — Summary of the combined shipping and handling costs - `tax_rate` string — Tax rate that was applied on shipping and handling costs as a decimal string - `total_cost_excl_tax` string — Total shipping and handling costs excluding taxes as a decimal string - `total_cost_incl_tax` string — Total shipping and handling costs including taxes as a decimal string - `total_tax` string — Total amount of taxes on shipping and handling as a decimal string - `fulfillment_cost` object — Summary of the fulfillment fee costs - `total_cost_excl_tax` string — Total fulfillment fee costs excluding taxes as a decimal string - `total_cost_incl_tax` string — Total fulfillment fee costs including taxes as a decimal string - `total_tax` string — Total amount of taxes on fulfillment fee as a decimal string - `tax_rate` unknown - `fees` object[] — All fees applied to Print Job - `currency` string — Print Job Fee currency - `fee_type` string — Print Job Fee type - `sku` string — Print Job Fee unique sku - `tax_rate` string — The tax rate applied to the fee as a decimal string - `total_cost_excl_tax` string — The total fee rate excluding tax as a decimal string - `total_cost_incl_tax` string — The total fee rate including tax as a decimal string - `total_tax` string — The total fee rate tax amount as a decimal string - `total_cost_excl_tax` string — Total costs of the job excluding taxes as a decimal string - `total_cost_incl_tax` string — Total costs of the job including taxes as a decimal string - `total_tax` string — Total amount of taxes on the job as a decimal string - `estimated_shipping_dates` object — The estimated ship and delivery dates for a Print-Job - `arrival_max` string — The slowest estimated delivery date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format - `arrival_min` string — The fastest estimated delivery date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format - `dispatch_max` string — The slowest estimated ship date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format - `dispatch_min` string — The fastest estimated ship date for a Print-Job in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)) format - `external_id` string — Arbitrary string to identify and connect a print job to your systems. Set it to an order number, a purchase order or whatever else works for your particular use case. - `id` number, required - `line_items` object[], required — The line items of a Print-Job, defining it's Printables and their quantities. The property name 'items' can be used instead. - `cover` union — Shorthand of the cover source definition. If used together with 'interior' , it can replace 'printable_normalization', Alternatively to both options, a 'printable_id' of an existing printable can be provided. - object - `source_md5_sum` string — A md5 hash of the source file to check it's integrity - `source_url` string, required — The url of the source file. - string — The url of the interior source file. - `external_id` string — Arbitrary string to identify and connect a print job to your systems. Set it to an order number, a purchase order or whatever else works for your particular use case - `id` number, required - `interior` union — Shorthand of the interior source definition. If used together with 'cover' , it can replace 'printable_normalization'. Alternatively to both options, a 'printable_id' of an existing printable can be provided. - object - `source_md5_sum` string — A md5 hash of the source file to check it's integrity - `source_url` string, required — The url of the source file. - string — The url of the interior source file. - `page_count` number — The page count of the printable - `pod_package_id` string — The id of the PodPackage of the printable of this line item - `printable_id` string, uuid — Id of the Printable of of this line item. It can be used instead of 'printable_normalization' / 'interior' / 'cover' - `printable_normalization` object — Represents the normalization processes of the interior and cover source files. Alternatively, 'interior' and 'cover' can be set as a shorthand for creation or a 'printable_id' of an existing printable can be provided. - `cover` object, required — Represents the normalization process of the cover source files - `job_id` number — The id of the normalization job (either a InteriorNormalizationJob or a CoverNormalizationJob) - `normalized_file` object — The resulting normalized file - `file_id` number - `filename` string — Filename of the normalized file - `source_md5_sum` string — A md5 hash of the source file to check it's integrity - `source_url` string, required — The url of the source file. - `interior` object, required — Represents the normalization process of the interior source files - `job_id` number — The id of the normalization job (either a InteriorNormalizationJob or a CoverNormalizationJob) - `normalized_file` object — The resulting normalized file - `file_id` number - `filename` string — Filename of the normalized file - `source_md5_sum` string — A md5 hash of the source file to check it's integrity - `source_url` string, required — The url of the source file. - `quantity` number, required — Quantity of printed books for this line item - `status` object, required — Status object that contains the actual line item processing status as well as additional status related data - `messages` object — A map of status related messages / data - `delay` string — Expected delay in hours for error status' - `error` string — General status error message - `info` string — General info message on the status - `printable_normalization` object — A map of printable normalization related messages / data - `cover` string[] — Array of messages related to the cover file normalization - `interior` string[] — Array of messages related to the interior file normalization - `timestamp` string — [ISO 8601](https://www.w3.org/TR/NOTE-datetime)) timestamp of last status change - `tracking_urls` union — Tracking url(s) - string - string[] - `tracking_id` string — Tracking id for this line item's shipment - `carrier_name` string — Name of the carrier handling shipment - `name` 'CREATED' | 'ACCEPTED' | 'REJECTED' | 'IN_PRODUCTION' | 'ERROR' | 'SHIPPED', required — The actual processing status of the Print-Job. - `title` string — The title of the line item. Should be on the cover. This field will become mandatory on October 1, 2019! - `tracking_id` string — Tracking id for this line item's shipment - `tracking_urls` string[] — A list of tracking urls for this line item's shipment. - `carrier_name` string — Name of the carrier handling shipment - `order_id` string — Reference to the order, which this PrintJob has created - `production_delay` integer — Delay before a newly created Print-Job is sent to production. Minimum is 60 minutes, maximum is 2880 minutes (=48 hours). As most cancellation requests occur right after an order has been placed, it makes sense to wait for some time before sending an order to production. Once production has started, orders cannot be canceled anymore. - `production_due_time` string, date-time — Target timestamp of when this job will move into production ([ISO 8601](https://www.w3.org/TR/NOTE-datetime)) - `shipping_address` object, required — The shipping address of the customer. - `city` string, required - `country_code` string, required — [ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) country code - `email` string, email, required — Shipping carriers require an email address for notifications or handling delivery issues. If no email is given, the default email in the user profile will be used. - `is_business` boolean — Only relevant for US addresses. Some US carriers don't deliver to business-addresses on Saturday. - `name` string, required — Full name of the person, including first and last name. - `organization` string — Name of an organization. Required if no person name is given. - `phone_number` string, required — Shipping carriers require a phone number for handling delivery issues. If no phone number is given, the default in the API user profile will be used. Validation Regex Pattern for phone numbers `^\+?[\d\s\-.\/()]{8,20}$` - `postcode` string, required — Required for most countries - `state_code` string — 2 or 3 letter state codes (officially called [ISO-3166-2 subdivision codes](https://en.wikipedia.org/wiki/ISO_3166-2)). They are required for some countries (e.g. US, MX, CA, AU) - `street1` string, required — First address line - `street2` string — Second address line - `title` 'MR' | 'MISS' | 'MRS' | 'MS' | 'DR' - `warnings` object[] — Warnings found during address validation - `type` string — Type of warning - `code` string — Warning code which describe what was suggested by validation - `path` string — Describes the validation origin of warning - `message` string — Warning message with suggested change - `suggested_address` object — Suggested address returned by shipping address validation - `country_code` string — Suggested country code - `state_code` string — Suggested state code - `postcode` string — Suggested postal code - `city` string — Suggested city - `street1` string — Suggested first address line - `street2` string — Suggested second address line - `shipping_level` 'MAIL' | 'PRIORITY_MAIL' | 'GROUND_HD' | 'GROUND_BUS' | 'GROUND' | 'EXPEDITED' | 'EXPRESS', required — The shipping level that this Print-Job is shipped with - `tax_country` string — [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the tax country determined for this job ## Other responses - `401` — Unauthorized - `403` — Forbidden --- [API](https://skmtc.dev/lulu/apis/universal-publishing-platform-api.md) · [All operations](https://skmtc.dev/lulu/apis/universal-publishing-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lulu/universal-publishing-platform-api/revisions/3119f71811f8/schema)