Exporting Reports
thanks.io lets you export order history, delivery stats, QR scan reports, and mailing list recipient data as CSV files.
Available exports
| Export | Where to find it | Contents |
|---|---|---|
| Order history | Orders → Export | All orders with status, mailer type, recipient, send date |
| QR scan report | QR Codes → Global Scan List → Export | Scan events with recipient, timestamp, and page |
| Mailing list recipients | Mailing Lists → [List] → Export | All recipients in a list as CSV |
How to export
- Navigate to the section with the data you want.
- Apply any date range or filter you need.
- Click Export or Download CSV.
- The file downloads to your browser.
Downloading order history
The order history download is available at the upper right of the Orders page. There are two download types:
Summary download
Best for accounting and high-level reporting. Each row represents one order and includes:
- Order ID and Subaccount ID
- Type, Size, Message
- Method (how it was sent)
- Status
- QR URL
- Total number of recipients
- Total cost
- Total number of QR scans
- Individual delivery statuses
- Created date
Details download
Best for troubleshooting or deeper analysis. Each row represents one individual recipient and includes:
- Recipient info (Name, Address, City, State, Zip, Country, Email, Phone, Custom1/2)
- Number of QR code scans for that recipient
- Message
- Order ID
- Type, Size
- Method
- Subaccount ID
Filters
When downloading order history you can filter by:
Method - how the order was placed:
| Method | Description |
|---|---|
| API | Orders sent via the API |
| Campaigns | Orders sent automatically by a Campaign |
| Card Builder | Orders placed using the Send Now button in the dashboard |
| Orders triggered by emailing send@thanks.io | |
| Zapier | Orders triggered via a Zapier integration |
Status - current state of the order:
| Status | Description |
|---|---|
| Reviewing | Within the 1-hour cancellation window after placing |
| Processing | Submitted to the printer, awaiting confirmation |
| Fulfilled | All processing complete |
| Printed | Printer has confirmed printing |
| Shipped | Printer has confirmed shipment |
| Cancelled | Cancelled during the Reviewing window; funds returned to balance |
| Failed | Failed due to technical errors |
Date - choose a date range. You can download up to 30 days of order history at a time.
Viewing order details
After placing an order, click the Details button on the dashboard to open its order details page.
Download a print proof
In the upper left of order details, you can download a PDF proof of the mailer that was printed.
Order tracking
The Delivery Summary section shows all known USPS tracking information for the order. Possible delivery statuses include:
- Processing - Order is queued for printing
- Printed - Order has been printed and mailed
- In Transit - Mail piece is being processed at the origin USPS facility
- In Local Area - Mail piece is being processed at the destination USPS facility
- Out for Delivery / Delivered - Mail piece has been cleared for delivery; should arrive within 1-2 business days
- Re-routed - USPS re-routed the piece due to a change of address, address error, or barcode relabeling
- Returned - USPS is returning the piece due to address or barcode errors
- Total Failed - The piece failed and was not printed; see the order items for the specific reason
Individual piece status
The Order Items section lists each recipient in the order with their individual delivery status. You can click View in the Back Message column to see the PDF proof for that specific recipient.
Do not scan the QR code when viewing an individual proof - it will register a real scan that cannot be deleted.
Errors
An error means a mailer was stopped before it could be sent. Common reasons include:
- Duplicate protection - A mailer was already sent to this address in the last 36 hours
- No-stat address - USPS classifies this property as vacant and unlikely to receive mail
- Incorrect address - A component of the address (street, city, state, or zip) is invalid
If you think an error is not valid, check the address shown in the order items against USPS's address tool at tools.usps.com.
Duplicate and no-stat protections can be adjusted in Order Error Settings. You will be responsible for any accidental mailings that result from disabling them.
Filtering and downloading order items
At the top of the Order Items section you can filter to show only errors or only QR scan events, which makes it easier to focus on specific issues or export a targeted list.
Tips
- Use the Summary download for accounting and the Details download when you need to see who scanned.
- Use the QR scan export to identify high-engagement contacts for follow-up campaigns.