---
title: "Get a Mail Item"
method: GET
path: "/v1/mail_items/{id}"
tags: ["mailItems"]
---

# Get a Mail Item

`GET /v1/mail_items/{id}`

Get a mail item by its unique identifier.

A Mail Item is a unit of physical mail received at a Lockbox.

## Path parameters

- `id` string, required

## Response `200`

Successfully retrieved the mail item.

- MailItem — A Mail Item represents a unit of physical mail. It has its own lifecycle and is the operational unit that reviewers act on. A Mail Item may produce zero or more Donations and zero or one Deposit, and carries the scanned artifacts (envelopes, checks, accompanying paperwork) associated with the receipt. Mail Items are created by Chariot when a lockbox provider uploads a batch of scanned mail. They are not created via the public API — to bring donation data and money in directly, use the Donations and Deposits APIs.
  - `id` string, required — The unique identifier for the mail item.
  - `lockbox_id` string — The unique identifier for the lockbox that received the mail item.
  - `status` 'processing' | 'needs_review' | 'processed' | 'rejected', required — The processing status of a Mail Item. - `processing`: The mail item is being scanned and parsed. - `needs_review`: Extraction completed but produced ambiguous results that require human review. - `processed`: The mail item has been successfully parsed and classified, and is ready for any downstream automations or workflows to run on it. - `rejected`: The mail item will not produce a Donation (e.g., return-to-sender, illegible, unrelated correspondence).
  - `received_at` string, date-time, required — The date and time when the mail item was physically received at the lockbox.
  - `scans` MailItemScan[], required — The scans taken of the mail item, newest first. A mail item typically has one scan; a second scan appears after an admin requests a rescan of the physical mail.
    - `file_id` string, required — The unique identifier for the scanned document file. Fetch contents via the File API.
    - `created_at` string, date-time, required — The date and time when the scan was taken.
  - `created_at` string, date-time, required — The date and time when the mail item record was created.
  - `updated_at` string, date-time, required — The date and time when the mail item record was last updated.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `404` — Resource Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/specs.md) · [All operations](https://skmtc.net/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/8446023e02fb/schema)