increase-test
GET/inbound_mail_items/{inbound_mail_item_id}

Retrieve an inbound mail item

Retrieves an inbound mail item delivered to a lockbox address. Supply inbound_mail_item_id to review the item’s processing status, scanned file, recipient details, and checks.

1 parameter
inbound_mail_item_idstringrequired
The identifier of the inbound mail item to retrieve.

3 status codes
200Returns the inbound mail item object, including its status, scanned file identifier, lockbox details, and checks.
account_idstringrequired
The identifier for the Account that checks in this mail item are deposited into. For mail items that could not be routed to a Lockbox Recipient, this will be null.
checksarray<InboundMailItemCheck>required
The checks in the mail item.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Inbound Mail Item was created.
file_idstringrequired
The identifier for the File containing the scanned contents of the mail item.
idstringrequired
The Inbound Mail Item identifier.
lockbox_address_idstringrequired
The identifier for the Lockbox Address that received this mail item.
lockbox_recipient_idstringrequired
The identifier for the Lockbox Recipient that received this mail item. For mail items that could not be routed to a Lockbox Recipient, this will be null.
recipient_namestringrequired
The recipient name as written on the mail item.
rejection_reasonstringrequired
If the mail item has been rejected, why it was rejected.
Allowed:no_matching_lockboxno_checklockbox_not_activelockbox_address_not_activelockbox_recipient_not_active
statusstringrequired
If the mail item has been processed.
Allowed:pendingprocessedrejected
typestringrequired
A constant representing the object's type. For this resource it will always be `inbound_mail_item`.
Allowed:inbound_mail_item
4XXReturned when the request encounters a client error.
5XXReturned when the server encounters an error.

Error handling

The inbound_mail_item_id path parameter identifies the inbound mail item to retrieve.