Retrieve an Inbound Mail Item

Changed on
get/inbound_mail_items/{inbound_mail_item_id}

Request

  • Base URL
    https://api.increase.com
  • URL
    https://api.increase.com/inbound_mail_items/{inbound_mail_item_id}
  • Auth
    HTTP bearer

Path parameters

inbound_mail_item_idstring required

The identifier of the Inbound Mail Item to retrieve.

Response

Inbound Mail Item

account_idstring nullable required

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.

created_atstring date-time required

The ISO 8601 time at which the Inbound Mail Item was created.

file_idstring required

The identifier for the File containing the scanned contents of the mail item.

idstring required

The Inbound Mail Item identifier.

lockbox_address_idstring required

The identifier for the Lockbox Address that received this mail item.

lockbox_recipient_idstring nullable required

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_namestring nullable required

The recipient name as written on the mail item.

rejection_reason'no_matching_lockbox' | 'no_check' | 'lockbox_not_active' | 'lockbox_address_not_active' | 'lockbox_recipient_not_active' nullable required

If the mail item has been rejected, why it was rejected.

status'pending' | 'processed' | 'rejected' required

If the mail item has been processed.

type'inbound_mail_item' required

A constant representing the object's type. For this resource it will always be inbound_mail_item.

Example response

{
  "account_id": "account_in71c4amph0vgo2qllky",
  "checks": [
    {
      "amount": 1750,
      "back_file_id": "file_makxrc67oh9l6sg7w9yc",
      "check_deposit_id": "check_deposit_f06n9gpg7sxn8t19lfc1",
      "front_file_id": "file_makxrc67oh9l6sg7w9yc",
      "status": "deposited"
    },
    {
      "amount": 1750,
      "back_file_id": "file_makxrc67oh9l6sg7w9yc",
      "check_deposit_id": "check_deposit_f06n9gpg7sxn8t19lfc1",
      "front_file_id": "file_makxrc67oh9l6sg7w9yc",
      "status": "deposited"
    }
  ],
  "created_at": "2020-01-31T23:59:59Z",
  "file_id": "file_makxrc67oh9l6sg7w9yc",
  "id": "inbound_mail_item_q6rrg7mmqpplx80zceev",
  "lockbox_address_id": "lockbox_address_lw6sbzl9ol5dfd8hdml6",
  "lockbox_recipient_id": "lockbox_3xt21ok13q19advds4t5",
  "recipient_name": "Ian Crease",
  "rejection_reason": null,
  "status": "processed",
  "type": "inbound_mail_item"
}

Changes

  • 21462c0df069Revision changes
    • info

      added the required property to the response with the status

  • 64a92a8cc343Revision changes
    • info

      added subschema #8 subschema #10 to the /// response property anyOf list for the response status

    • info

      added subschema #8 subschema #10 to the /// response property anyOf list for the response status

    • info

      removed subschema #8 subschema #10 from the /// response property anyOf list for the response status

    • info

      removed subschema #8 subschema #10 from the /// response property anyOf list for the response status