> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intelliprint.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracking Print Jobs

> Keep track of your mailings.

<Note>
  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.
</Note>

## 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.

<CodeGroup>
  ```javascript Node.js SDK theme={null}
  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`.
  }
  ```

  ```bash cURL theme={null}
  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.
  ```
</CodeGroup>

## Mail Item Statuses

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

| 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. |
