General

Tracking Print Jobs

Keep track of your mailings.

Doc cover pending

Diagram or screenshot for the "Tracking Print Jobs" doc page: visual that anchors what this doc explains (request flow, dashboard surface, or worked example).

Awaiting upload

On this page

Checking the Status of a Print Job

Each mail item in a print job has its own status. While most items in a print job might have already been sent, some larger items might still be in production.

Node.js SDK

Node.js

import Intelliprint from 'intelliprint'

const ip = new Intelliprint('your-api-key-here')

const printJob = await ip.prints.retrieve('print-job-id')

// Check the status of each letter in the print job.
for (const item of printJob.letters) {
  console.log(`Letter ${item.id} is: ${item.status}`)
  // For tracked postage services, you can access the tracking number in `item.tracking_number`.
}

cURL

curl https://api.intelliprint.net/v1/prints/print-job-id \
  -H 'Authorization: YOUR_API_KEY'
# Check the status of each letter in the print job.

Mail Item Statuses

Each mail item moves through various statuses as it is processed.

Mail item statuses and their meaning.
Status	Description
`draft`	The print job has not been confirmed yet.
`waiting_to_print`	The mail item is waiting to be printed.
`printing`	The mail item is being printed.
`enclosing`	The mail item is being enclosed.
`shipping`	The mail item is waiting to be picked up by the postage service.
`sent`	The mail item has been sent.
`returned`	The mail item has been returned back to Intelliprint. A return reason and date is attached in the `returned` field of the mail item.
`cancelled`	The mail item has been cancelled by the user.
`invalid_address`	The mail item was refused to be picked up by the postage service as the address was deemed invalid by them. This status is very rare and only possible for tracked postage services.

Status: draft
Description: The print job has not been confirmed yet.

Status: waiting_to_print
Description: The mail item is waiting to be printed.

Status: printing
Description: The mail item is being printed.

Status: enclosing
Description: The mail item is being enclosed.

Status: shipping
Description: The mail item is waiting to be picked up by the postage service.

Status: sent
Description: The mail item has been sent.

Status: returned
Description: The mail item has been returned back to Intelliprint. A return reason and date is attached in the returned field of the mail item.

Status: cancelled
Description: The mail item has been cancelled by the user.

Status: invalid_address
Description: The mail item was refused to be picked up by the postage service as the address was deemed invalid by them. This status is very rare and only possible for tracked postage services.