List Mail Items

List mail items for your account. A Mail Item is a unit of physical mail received at a Lockbox. It has its own lifecycle and is the operational unit reviewers act on. Each Mail Item may produce zero or more Donations and zero or one Deposit.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

limitintegerOptional

Limit the size of the list that is returned. The default (and maximum) is 100 objects.

page_tokenstringOptional

The cursor to use for pagination. If not set, the first page of results will be returned.

lockbox_idstringOptional

The unique identifier for the lockbox to filter mail items by.

status.inlist of enumsOptional

Filter Mail Items to only those with the specified status. For GET requests, this should be encoded as a comma-delimited string, such as ?status.in=needs_review,processing.

Allowed values:

created_at.afterdatetimeOptional

Return mail items created after the given date and time.

created_at.beforedatetimeOptional

Return mail items created before the given date and time.

Response headers

X-Request-IdstringOptional

The unique identifier for the request

Response

The response for MailItems.list

resultslist of objectsOptional

next_page_tokenstringOptional

A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error

$	curl -G https://api.givechariot.com/v1/mail_items \
>	-H "Authorization: Bearer <token>" \
>	-d lockbox_id=lockbox_01j8rs605a4gctmbm58d87mvsj \
>	-d status.in=needs_review

1	{
2	"results": [
3	{
4	"id": "mail_01j8rs605a4gctmbm58d87mvsj",
5	"status": "processed",
6	"received_at": "2020-01-31T23:59:59Z",
7	"scans": [
8	{
9	"file_id": "file_01j8rs605a4gctmbm58d87mvsj",
10	"created_at": "2020-01-31T23:59:59Z"
11	}
12	],
13	"created_at": "2020-01-31T23:59:59Z",
14	"updated_at": "2020-01-31T23:59:59Z",
15	"lockbox_id": "lockbox_01j8rs605a4gctmbm58d87mvsj"
16	}
17	],
18	"next_page_token": "string"
19	}