---
updatedAt: 2026-09-21T10:35:20.000Z
agentTools:
  projectIndex: https://developers.marq.com/llms.txt
---

# Print order object

The Print Order APIs allow for the manipulation of print orders and job orders within Marq.

## Print order object

The Document Folder APIs allow for the manipulation of folders and team folders within Marq.

[block:parameters]
{
  "data": {
    "h-0": "Attribute",
    "0-0": "**orderId** _[ID](https://lucidpress.readme.io/reference/types)_  \nUnique ID of the project.",
    "1-0": "**printJobs** _Array of Objects - see Job Order object below_  \nSee contactInfo details below.",
    "2-0": "**rushOrder** _[Boolean](https://lucidpress.readme.io/reference/types)_  \nUnique ID of the project.",
    "3-0": "**reprint** _[Boolean](https://lucidpress.readme.io/reference/types)_  \nUnique ID of the project.",
    "4-0": "**contactInfo** _Object - see Contact Info object below_  \nSee contactInfo details below.",
    "5-0": "**notes** _[String](https://lucidpress.readme.io/reference/types)_  \nSpecial notes can be added by the end-user during the print order checkout flow.",
    "6-0": "**shippingPrice** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe price of shipment which is calculated in USD. In special cases where users do not pay for the order through Marq, but are instead billed directly by the print vendor, the shipping price is included in the object.",
    "7-0": "**totalPriceWithoutTax** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe total price of the order with the exclusion of taxes. In special cases where users do not pay for the order through Marq, but are instead billed directly by the print vendor, the shipping price is included in the object."
  },
  "cols": 1,
  "rows": 8,
  "align": [
    "left"
  ]
}
[/block]

```json Print order object
{
    "orderId": number,
    "jobs": array[PrintJob],
    "status": string,
    "created": dateTime,
    "lastModified": dateTime,
    "rushOrder": boolean,
    "reprint": boolean,
    "contactInfo": ContactInfo,
    "notes": string,
    "shippingPrice": integer,
    "totalPriceWithoutTax": integer
}
```

## Contact info object

[block:parameters]
{
  "data": {
    "h-0": "Attribute",
    "0-0": "**name** _[String](https://lucidpress.readme.io/reference/types)_  \nThe name of the user that submitted the print order request",
    "1-0": "**email** _[String](https://lucidpress.readme.io/reference/types)_  \nThe email of the user that submitted the print order request.",
    "2-0": "**billingCodes** _[String](https://lucidpress.readme.io/reference/types)_  \nThe billing code(s) associated with the user that submitted the print order request. These are often added into Marq for each user as the printer's billing code."
  },
  "cols": 1,
  "rows": 3,
  "align": [
    "left"
  ]
}
[/block]

```json Contact info object
{
    "name": string,
    "email": string,
    "billingCodes": string
}
```

## Job order object

[block:parameters]
{
  "data": {
    "h-0": "Attribute",
    "0-0": "**jobId** _[ID](https://lucidpress.readme.io/reference/types)_  \nUnique ID of the project.",
    "1-0": "**printJobs** _Array of Objects - see Job Order object below_  \nSee contactInfo details below.",
    "2-0": "**rushOrder** _[Boolean](https://lucidpress.readme.io/reference/types)_  \nUnique ID of the project.",
    "3-0": "**reprint** _[Boolean](https://lucidpress.readme.io/reference/types)_  \nUnique ID of the project.",
    "4-0": "**contactInfo** _Object - see Contact Info object below_  \nSee contactInfo details below.",
    "5-0": "**notes** _[String](https://lucidpress.readme.io/reference/types)_  \nSpecial notes can be added by the end-user during the print order checkout flow.",
    "6-0": "**shippingPrice** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe price of shipment which is calculated in USD. In special cases where users do not pay for the order through Marq, but are instead billed directly by the print vendor, the shipping price is included in the object.",
    "7-0": "**totalPriceWithoutTax** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe total price of the order with the exclusion of taxes. In special cases where users do not pay for the order through Marq, but are instead billed directly by the print vendor, the shipping price is included in the object."
  },
  "cols": 1,
  "rows": 8,
  "align": [
    "left"
  ]
}
[/block]

```json Job order object
{
    "jobId": string,
    "title": string,
    "projectURL": string,
    "csvURL": string (optional),
    "quantity": number,
    "shippingAddress": ShippingAddress,
    "shippingMethod": string,
    "jobOptions": JobOptions,
    "notes": string,
    "externalProductId": string
}
```

## Shipping address object

[block:parameters]
{
  "data": {
    "h-0": "Attribute",
    "0-0": "**name** _[String](https://lucidpress.readme.io/reference/types)_  \nName of person for the shipping address.",
    "1-0": "**address1** _[String](https://lucidpress.readme.io/reference/types)_  \nStreet address for shipping.",
    "2-0": "**address2** _[String](https://lucidpress.readme.io/reference/types)_  \nUnit number or additional attributes for shipping address.",
    "3-0": "**city** _[String](https://lucidpress.readme.io/reference/types)_  \nCity of the shipping address.",
    "4-0": "**state** _[String](https://lucidpress.readme.io/reference/types)_  \nState of the shipping address.",
    "5-0": "**country** _[String](https://lucidpress.readme.io/reference/types)_  \nCountry of the shipping address.",
    "6-0": "**zipcode** _[String](https://lucidpress.readme.io/reference/types)_  \nThe postal code for the shipping address."
  },
  "cols": 1,
  "rows": 7,
  "align": [
    "left"
  ]
}
[/block]

```json Shipping address object
{ 
    "name": string,
    "address1": string,
    "address2": string (optional), 
    "city": string,
    "state": string,
    "country": string,
    "zipcode": string
}
```

## Job options object

[block:parameters]
{
  "data": {
    "h-0": "Attribute",
    "0-0": "**width** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe unit number for the width of the PDF.",
    "1-0": "**height** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe unit number for the width of the PDF.",
    "2-0": "**units** _[String](https://lucidpress.readme.io/reference/types)_  \nThe measurement unit of the PDF (mm, inches, etc.)",
    "3-0": "**description** _[String](https://lucidpress.readme.io/reference/types)_  \nThe title of the PDF or Marq Project",
    "4-0": "**productType** _[String](https://lucidpress.readme.io/reference/types)_  \nThe product type selected from the print checkout.",
    "5-0": "**duplex** _[Boolean](https://lucidpress.readme.io/reference/types)_  \nWhether the product should be printed on both sides of the paper.",
    "6-0": "**pageCount** _[Integer](https://lucidpress.readme.io/reference/types)_  \nThe number of pages for the PDF",
    "7-0": "**coating** _[String](https://lucidpress.readme.io/reference/types)_  \nThe selected coating for the requested print job.",
    "8-0": "**folds** _[String](https://lucidpress.readme.io/reference/types)_  \nThe selected folds for the requested print job",
    "9-0": "**finish** _[String](https://lucidpress.readme.io/reference/types)_  \nThe selected finish for the requested print job",
    "10-0": "**coverMedia** _[String](https://lucidpress.readme.io/reference/types)_  \nThe media to be used for covers for the requested print job.",
    "11-0": "**upgrades** _[Object](https://lucidpress.readme.io/reference/types)_  \nAdditional upgrades requested based on the product selected in the print request."
  },
  "cols": 1,
  "rows": 12,
  "align": [
    "left"
  ]
}
[/block]

```json Job options object
{
    "width": number,
    "height": number,
    "units": string,
    "description": string,
    "productType": string,
    "media": string,
    "duplex": boolean (optional),
    "pageCount": number,
    "coating": string (optional),
    "folds": string (optional),
    "finish": string (optional),
    "coverMedia": string (optional),
    "upgrades": object
}
```

## Example payload of print order

```json Example of print order object
{
	"id": "00000000-0000-0000-0000-000000000000",
	"object": "printOrder",
	"jobs": [{
		"id": "00000000-0000-0000-0000-000000000000",
		"title": "Blank Print Document",
		"documentUrl": "<link to pdf>",
		"csvUrl": null,
		"quantity": 100,
		"shippingAddress": {
			"name": "Firstname Lastname",
			"address1": "Address line 1",
			"address2": "",
			"city": "City",
			"state": null,
			"country": "US",
			"zipcode": "11111",
			"phone": "1111111111"
		},
		"shippingMethod": "Misc",
		"options": {
			"width": 210,
			"height": 297,
			"units": "mm",
			"description": "A4 Flyer (Landscape)",
			"productType": "standard",
			"media": "Satin Matt Art (FSC Mix) 350GSM",
			"duplex": false,
			"pageCount": 1,
			"coating": null,
			"folds": null,
			"finish": null,
			"coverMedia": null,
			"upgrades": []
		},
		"notes": null,
		"externalProductId": "BFT001"
	}],
	"status": "Printing",
	"created": "2021-05-27T12:34:56Z",
	"lastModified": "2021-05-27T12:34:56Z",
	"rushOrder": false,
	"reprint": false,
	"contact": {
		"name": "First Last",
		"email": "example@example.com",
		"billingCodes": "N/A"
	},
	"shippingPrice": 0,
	"totalPriceWithoutTax": 55
}
```