Skip to main content
GET
/
orders
/
{orderId}
/
track
Track Order
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.thanks.io/api/v2/orders/{orderId}/track', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "data": {
    "id": 42708,
    "order": {
      "sub_account_id": null,
      "type": "postcard",
      "message": "Hey %FIRST_NAME%!,\n\nTHANK YOU for allowing us the opportunity to HELP you with your plan!",
      "style": 1,
      "size": "4x6",
      "front_image": "https://d2md0c8rpvzmz5.cloudfront.net/letter-backgrounds/bg0.png",
      "high_quality_preview": "",
      "total_estimated_recipients": 2,
      "authorization_total": 146,
      "total_recipients": 1,
      "grand_total": 73,
      "status": "Fulfilled",
      "method": "Campaign",
      "created_at": "2025-09-08 16:05:12",
      "updated_at": "2025-09-08 16:06:08"
    },
    "stats": {
      "delivered": 0,
      "processing": 0,
      "printed": 1,
      "in_transit": 0,
      "in_local_area": 0,
      "processed_for_delivery": 0,
      "re_routed": 0,
      "returned_to_sender": 0,
      "failed": 0,
      "scans": 0,
      "multi_scans": 0
    },
    "errors": [
      {
        "name": "Current Resident",
        "address": "1 Main Street",
        "address2": "",
        "city": "Fake City",
        "province": "FC",
        "postal_code": "12345",
        "country": "US",
        "failure": "USPS lists address as 'no-stat' - address is unlikely to receive mail."
      }
    ],
    "returned": []
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.thanks.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer token authentication using your thanks.io API key

Path Parameters

orderId
string
required

Response

200 - application/json

OK

data
object