--- updatedAt: 2026-09-21T10:35:21.000Z agentTools: projectIndex: https://developers.marq.com/llms.txt --- # Update print order(s) ### OAuth 2.0 User Token and Account Token Scope: * [Print.Orders](https://developers.marq.com/reference/access-token-scopes) ## Status updates **One status update per order**\ Currently, only one status update per order is accepted. The jobId can be the ID of any job in the order. Status updates for "add-on" jobs are not needed and will not be accepted **Status order\ **A status update on a job will only be accepted if the new status is a valid transition from the current status. Valid transitions are: * SentToVendor -> ReceivedByVendor, Printing, Shipping, OnHold, or Cancelled * ReceivedByVendor -> Printing, Shipping, OnHold, or Cancelled * Printing -> OnHold or Shipping * Shipping -> Shipping (terminal state, but updates to shipping information are allowed) * OnHold -> ReceivedByVendor, Printing, Shipping, or Cancelled * Cancelled -> N/A (terminal state) ## Optional updates for Shipping status The optional keys (trackingNumber, shippingCarrier, shippingMethod, and dateShipped) are only required when the status is Shipping The format for the shipping date is MM/DD/YYYY HH:MM:SS \[AM|PM]
# Parameters # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "marq-v1", "version": "1" }, "servers": [ { "url": "https://api.marq.com/" } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://example.com/oauth2/token", "scopes": {} } } } } }, "security": [ { "sec0": [] } ], "paths": { "/v1/print/orders": { "post": { "summary": "Update print order(s)", "description": "", "operationId": "update-print-orders", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "RAW_BODY": { "type": "string", "description": "Update orders by adding the orderId and any other parameters that need an update.", "default": "[ { \"orderId\": 1, \"jobId\": 1, \"status\": \"Shipping\", \"trackingNumber\": \"9400000000000000000000\", \"shippingCarrier\": \"USPS\", \"shippingMethod\": \"USPS Priority\", \"dateShipped\": \"04/17/2018 11:00:00 AM\" }, { \"orderId\": 2, \"jobId\": 1, \"status\": \"Printing\" }, { \"orderId\": 2, \"jobId\": 2, \"status\": \"SomeInvalidStatus\" }, { \"orderId\": 2, \"jobId\": 3, \"status\": \"Printing\" }, { \"orderId\": 3, \"jobId\": 1, \"status\": \"ReceivedByVendor\" }, { \"orderId\": 3, \"jobId\": 2, \"status\": \"ReceivedByVendor\" }, { \"orderId\": 4, \"jobId\": 1, \"status\": \"Printing\" } ]" } } } } } }, "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Result": { "value": "\t[{\n\t\t\t\"orderId\": \"123\",\n\t\t\t\"printJobs\": [{\n\t\t\t\t\"jobId\": \"4455\",\n\t\t\t\t\"title\": \"Kyle Beckerman - Business Cards\",\n\t\t\t\t\"documentURL\": \"https://print.app.marq.com/printResource?resource=f0049157-4a94-48b3-83c0-ecf1f6ee33db&expiry=1653071255&signature=54d643df731b2bcd6e0a2e0dfda980f407834r54&mimeType=application/pdf\",\n\t\t\t\t\"csvURL\": null,\n\t\t\t\t\"quantity\": 500,\n\t\t\t\t\"shippingAddress\": {\n\t\t\t\t\t\"name\": \"Kyle Beckerman\",\n\t\t\t\t\t\"address1\": \"123 Main Street\",\n\t\t\t\t\t\"address2\": \"\",\n\t\t\t\t\t\"city\": \"Salt Lake City \",\n\t\t\t\t\t\"state\": \"Utah\",\n\t\t\t\t\t\"country\": \"US\",\n\t\t\t\t\t\"zipcode\": \"84045\",\n\t\t\t\t\t\"phone\": \"801 489 0896\"\n\t\t\t\t},\n\t\t\t\t\"shippingMethod\": \"Misc\",\n\t\t\t\t\"jobOptions\": {\n\t\t\t\t\t\"width\": 90,\n\t\t\t\t\t\"height\": 55,\n\t\t\t\t\t\"units\": \"mm\",\n\t\t\t\t\t\"description\": \"Business Card\",\n\t\t\t\t\t\"productType\": \"standard\",\n\t\t\t\t\t\"media\": \"Satin Matt Art (FSC Mix) 350GSM\",\n\t\t\t\t\t\"duplex\": true,\n\t\t\t\t\t\"pageCount\": 1,\n\t\t\t\t\t\"coating\": null,\n\t\t\t\t\t\"folds\": null,\n\t\t\t\t\t\"finish\": null,\n\t\t\t\t\t\"coverMedia\": null,\n\t\t\t\t\t\"upgrades\": []\n\t\t\t\t},\n\t\t\t\t\"notes\": null,\n\t\t\t\t\"externalProductId\": \"ABC034\"\n\t\t\t}],\n\t\t\t\"rushOrder\": false,\n\t\t\t\"reprint\": false,\n\t\t\t\"contactInfo\": {\n\t\t\t\t\"name\": \"Kyle Beckerman\",\n\t\t\t\t\"email\": \"kylebeckerman@rsl.com\",\n\t\t\t\t\"billingCodes\": \"KB5\"\n\t\t\t},\n\t\t\t\"shippingPrice\": 0,\n\t\t\t\"totalPriceWithoutTax\": 75\n\t\t},\n\t\t{\n\t\t\t\"orderId\": \"789\",\n\t\t\t\"printJobs\": [{\n\t\t\t\t\"jobId\": \"63724\",\n\t\t\t\t\"title\": \"Business Cards 2 Sided Individuals\",\n\t\t\t\t\"documentURL\": \"https://print.app.marq.com/printResource?resource=0d6eeeff-b770-4ed6-be11-005f82efd3ab&expiry=1653071236&signature=f2481e433c3a1a11bf155984a0c9b5d6d630775b&mimeType=application/pdf\",\n\t\t\t\t\"csvURL\": null,\n\t\t\t\t\"quantity\": 500,\n\t\t\t\t\"shippingAddress\": {\n\t\t\t\t\t\"name\": \"Javier Morales\",\n\t\t\t\t\t\"address1\": \"68 Lion Street, \",\n\t\t\t\t\t\"address2\": \"\",\n\t\t\t\t\t\"city\": \"Sandy\",\n\t\t\t\t\t\"state\": \"Utah\",\n\t\t\t\t\t\"country\": \"US\",\n\t\t\t\t\t\"zipcode\": \"84045\",\n\t\t\t\t\t\"phone\": \"8013853285\"\n\t\t\t\t},\n\t\t\t\t\"shippingMethod\": \"Misc\",\n\t\t\t\t\"jobOptions\": {\n\t\t\t\t\t\"width\": 90,\n\t\t\t\t\t\"height\": 55,\n\t\t\t\t\t\"units\": \"mm\",\n\t\t\t\t\t\"description\": \"Business Card\",\n\t\t\t\t\t\"productType\": \"standard\",\n\t\t\t\t\t\"media\": \"Satin Matt Art (FSC Mix) 350GSM\",\n\t\t\t\t\t\"duplex\": true,\n\t\t\t\t\t\"pageCount\": 1,\n\t\t\t\t\t\"coating\": null,\n\t\t\t\t\t\"folds\": null,\n\t\t\t\t\t\"finish\": null,\n\t\t\t\t\t\"coverMedia\": null,\n\t\t\t\t\t\"upgrades\": []\n\t\t\t\t},\n\t\t\t\t\"notes\": null,\n\t\t\t\t\"externalProductId\": \"BFT034\"\n\t\t\t}],\n\t\t\t\"rushOrder\": false,\n\t\t\t\"reprint\": false,\n\t\t\t\"contactInfo\": {\n\t\t\t\t\"name\": \"Javier Morales\",\n\t\t\t\t\"email\": \"j.morales@rsl.com\",\n\t\t\t\t\"billingCodes\": \"JM11\"\n\t\t\t},\n\t\t\t\"shippingPrice\": 0,\n\t\t\t\"totalPriceWithoutTax\": 75\n\t\t}\n\t]" } }, "schema": { "type": "array", "items": { "type": "object", "properties": { "orderId": { "type": "string", "example": "123" }, "printJobs": { "type": "array", "items": { "type": "object", "properties": { "jobId": { "type": "string", "example": "4455" }, "title": { "type": "string", "example": "Kyle Beckerman - Business Cards" }, "documentURL": { "type": "string", "example": "https://print.app.marq.com/printResource?resource=f0049157-4a94-48b3-83c0-ecf1f6ee33db&expiry=1653071255&signature=54d643df731b2bcd6e0a2e0dfda980f407834r54&mimeType=application/pdf" }, "csvURL": {}, "quantity": { "type": "integer", "example": 500, "default": 0 }, "shippingAddress": { "type": "object", "properties": { "name": { "type": "string", "example": "Kyle Beckerman" }, "address1": { "type": "string", "example": "123 Main Street" }, "address2": { "type": "string", "example": "" }, "city": { "type": "string", "example": "Salt Lake City " }, "state": { "type": "string", "example": "Utah" }, "country": { "type": "string", "example": "US" }, "zipcode": { "type": "string", "example": "84045" }, "phone": { "type": "string", "example": "801 489 0896" } } }, "shippingMethod": { "type": "string", "example": "Misc" }, "jobOptions": { "type": "object", "properties": { "width": { "type": "integer", "example": 90, "default": 0 }, "height": { "type": "integer", "example": 55, "default": 0 }, "units": { "type": "string", "example": "mm" }, "description": { "type": "string", "example": "Business Card" }, "productType": { "type": "string", "example": "standard" }, "media": { "type": "string", "example": "Satin Matt Art (FSC Mix) 350GSM" }, "duplex": { "type": "boolean", "example": true, "default": true }, "pageCount": { "type": "integer", "example": 1, "default": 0 }, "coating": {}, "folds": {}, "finish": {}, "coverMedia": {}, "upgrades": { "type": "array", "items": { "type": "object", "properties": {} } } } }, "notes": {}, "externalProductId": { "type": "string", "example": "ABC034" } } } }, "rushOrder": { "type": "boolean", "example": false, "default": true }, "reprint": { "type": "boolean", "example": false, "default": true }, "contactInfo": { "type": "object", "properties": { "name": { "type": "string", "example": "Kyle Beckerman" }, "email": { "type": "string", "example": "kylebeckerman@rsl.com" }, "billingCodes": { "type": "string", "example": "KB5" } } }, "shippingPrice": { "type": "integer", "example": 0, "default": 0 }, "totalPriceWithoutTax": { "type": "integer", "example": 75, "default": 0 } } } } } } }, "4XX": { "description": "4XX", "content": { "application/json": { "examples": { "Result": { "value": "{\n \"code\": \"string\",\n \"message\": \"detailed explanation\",\n \"moreInfo\": \"https://api.marq.com/docs/errors#{error}\"\n}" } }, "schema": { "type": "object", "properties": { "code": { "type": "string", "example": "string" }, "message": { "type": "string", "example": "detailed explanation" }, "moreInfo": { "type": "string", "example": "https://api.marq.com/docs/errors#{error}" } } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```