Skip to main content
Intelliprint tracks the status of your mail items as they move through the production steps. Most cheaper postage services do not provide tracking once an item has left our facility. For postage services that do provide tracking, we provide the tracking number in the response of the API.

​
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. 
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`.
}

​
Mail Item Statuses

Each mail item moves through various statuses as it is processed.
StatusDescription
draftThe print job has not been confirmed yet.
waiting_to_printThe mail item is waiting to be printed.
printingThe mail item is being printed.
enclosingThe mail item is being enclosed.
shippingThe mail item is waiting to be picked up by the postage service.
sentThe mail item has been sent.
returnedThe mail item has been returned back to Intelliprint. A return reason and date is attached in the returned field of the mail item.
cancelledThe mail item has been cancelled by the user.
invalid_addressThe 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.