GET
/
orders
/
{orderId}
/
track
Track Order
const url = 'https://api.thanks.io/api/v2/orders/{orderId}/track';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}, body: undefined};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
{
  "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://s3.amazonaws.com/cdn.thanks.io/user_image_library/gFBaJJJWRp60op3ZOoK7UaO5I7zi33rdKQGgHylR.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": []
  }
}

Authorizations

Authorization
string
header
required

Bearer token authentication using your thanks.io API key

Path Parameters

orderId
string
required

Response

200 - application/json

OK

The response is of type object.