# Lob.com Tracking Events API

**Canonical:** https://apis.io/apis/lobcom/lobcom-tracking-events-api/  
**Provider:** Lob.com — https://apis.io/providers/lobcom/  
**Base URL:** https://api.lob.com/v1  
**Documentation:** https://docs.lob.com/

Lob.com Tracking Events API is one of 32 APIs that [Lob.com](https://apis.io/providers/lobcom/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Tracking Events. The published artifact set on APIs.io includes an OpenAPI specification.

As mailpieces travel through the mail stream, USPS scans their unique barcodes, and Lob processes these mail scans to generate tracking events. <h3>Certified Tracking Event Details</h3> Letters sent with USPS Certified Mail are fully tracked by USPS, and therefore their [tracking events](#operation/tracking_event) have an additional `details` object with more detailed information about the tracking event. The following table shows the potential values for the fields in the `details` object mapped to the tracking event `name`. <table> <tr> <th style="white-space: nowrap">NAME</th> <th style="white-space: nowrap">EVENT</th> <th style="white-space: nowrap">DESCRIPTION</th> <th style="white-space: nowrap">ACTION REQUIRED</th> </tr> <tr> <td style="white-space: nowrap">Mailed</td> <td style="white-space: nowrap"><code>package_accepted</code></td> <td>Package has been accepted into the carrier network for delivery.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">In Transit</td> <td style="white-space: nowrap"><code>package_arrived</code></td> <td>Package has arrived at an intermediate location in the carrier network.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">In Transit</td> <td style="white-space: nowrap"><code>package_departed</code></td> <td>Package has departed from an intermediate location in the carrier network.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">In Transit</td> <td style="white-space: nowrap"><code>package_processing</code></td> <td>Package is processing at an intermediate location in the carrier network.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">In Transit</td> <td style="white-space: nowrap"><code>package_processed</code></td> <td>Package has been processed at an intermediate location.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">In Local Area</td> <td style="white-space: nowrap"><code>package_in_local_area</code></td> <td>Package is at a location near the end destination.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Processed For Delivery</td> <td style="white-space: nowrap"><code>delivery_scheduled</code></td> <td>Package is scheduled for delivery.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Processed For Delivery</td> <td style="white-space: nowrap"><code>out_for_delivery</code></td> <td>Package is out for delivery.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Pickup Available</td> <td style="white-space: nowrap"><code>pickup_available</code></td> <td>Package is available for pickup at carrier location.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Delivered</td> <td style="white-space: nowrap"><code>delivered</code></td> <td>Package has been delivered.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Re-Routed</td> <td style="white-space: nowrap"><code>package_forwarded</code></td> <td>Package has been forwarded.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Returned to Sender</td> <td style="white-space: nowrap"><code>returned_to_sender</code></td> <td>Package is to be returned to sender.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>address_issue</code></td> <td>Address information is incorrect. Contact carrier to ensure delivery.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>contact_carrier</code></td> <td>Contact the carrier for more information.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>delayed</code></td> <td>Delivery of package is delayed.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>delivery_attempted</code></td> <td>Delivery of package has been attempted. Contact carrier to ensure delivery.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>delivery_rescheduled</code></td> <td>Delivery of package has been rescheduled.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>location_inaccessible</code></td> <td>Delivery location inaccessible to carrier. Contact carrier to ensure delivery.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>notice_left</code></td> <td>Carrier left notice during attempted delivery. Follow carrier instructions on notice.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>package_damaged</code></td> <td>Package has been damaged. Contact carrier for more details.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>package_disposed</code></td> <td>Package has been disposed.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>package_held</code></td> <td>Package held at carrier location. Contact carrier for more details.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>package_lost</code></td> <td>Package has been lost. Contact carrier for more details.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>package_unclaimed</code></td> <td>Package is unclaimed.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>package_undeliverable</code></td> <td>Package is not able to be delivered.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>reschedule_delivery</code></td> <td>Contact carrier to reschedule delivery.</td> <td style="white-space: nowrap"><code>true</code></td> </tr> <tr> <td style="white-space: nowrap">Issue</td> <td style="white-space: nowrap"><code>other</code></td> <td>Unrecognized carrier status.</td> <td style="white-space: nowrap"><code>false</code></td> </tr> </table> <div class="back-to-top" ><a href="#" onclick="toTopLink()">back to top</a></div>

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/lobcom/refs/heads/main/openapi/lobcom-tracking-events-api-openapi.yml

## Other Lob.com APIs (12)

- [Lob.com Accounts API](https://apis.io/apis/lobcom/lobcom-accounts-api/)
- [Lob.com Addresses API](https://apis.io/apis/lobcom/lobcom-addresses-api/)
- [Lob.com Bank Accounts API](https://apis.io/apis/lobcom/lobcom-bank-accounts-api/)
- [Lob.com Billing Groups API](https://apis.io/apis/lobcom/lobcom-billing-groups-api/)
- [Lob.com Booklets API](https://apis.io/apis/lobcom/lobcom-booklets-api/)
- [Lob.com Buckslip Orders API](https://apis.io/apis/lobcom/lobcom-buckslip-orders-api/)
- [Lob.com Buckslips API](https://apis.io/apis/lobcom/lobcom-buckslips-api/)
- [Lob.com Campaigns API](https://apis.io/apis/lobcom/lobcom-campaigns-api/)
- [Lob.com Card Orders API](https://apis.io/apis/lobcom/lobcom-card-orders-api/)
- [Lob.com Cards API](https://apis.io/apis/lobcom/lobcom-cards-api/)
- [Lob.com Checks API](https://apis.io/apis/lobcom/lobcom-checks-api/)
- [Lob.com Creatives API](https://apis.io/apis/lobcom/lobcom-creatives-api/)

## Tags

Tracking Events

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lobcom/lobcom-tracking-events-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lobcom/.