curl --request POST \
  --url https://aropay.aro.media/api/v1/transfer/letter/{id}/mail \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "deliveryMethod": "tracked"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({deliveryMethod: 'tracked'})
};

fetch('https://aropay.aro.media/api/v1/transfer/letter/{id}/mail', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://aropay.aro.media/api/v1/transfer/letter/{id}/mail"

payload = { "deliveryMethod": "tracked" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "ok": true,
  "data": {
    "letter": {
      "id": "cklet0001abcd",
      "status": "MAILED",
      "chainId": 11155111,
      "amount": "50.00",
      "token": "cAROUSD",
      "amountVisibility": "sealed",
      "memo": "Thanks for the referral",
      "recipient": {
        "name": "Jane Doe",
        "address": {
          "line1": "12 Adeola Odeku Street",
          "line2": "Victoria Island",
          "landmark": "Opposite Eko Hotel",
          "city": "Lagos",
          "region": "LA",
          "postal": null,
          "country": "NG",
          "countryName": "Nigeria"
        }
      },
      "isDomestic": false,
      "expiresAt": "2026-10-22T09:45:00.000Z",
      "sender": {
        "walletId": "ckwlt0001abcd",
        "address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72"
      },
      "claimCode": "7K3M-Q9TX-2ABF-H8RD-5CWN-VGP4-0J6Y",
      "claimUrl": "https://dev.aropay.aro.media/claim#7K3M-Q9TX-2ABF-H8RD-5CWN-VGP4-0J6Y",
      "pdfUrl": "https://dev.aropay.aro.media/api/v1/transfer/letter/cklet0001abcd/pdf",
      "escrow": {
        "transactionId": "cktxn0005abcd",
        "txHash": "0x4d1e…",
        "explorerUrl": "https://sepolia.etherscan.io/tx/0x4d1e…",
        "status": "CONFIRMED",
        "verified": true
      },
      "claim": null,
      "refund": null,
      "mail": {
        "provider": "lob",
        "providerId": "ltr_4868c3b5655f1f5c",
        "deliveryMethod": "tracked",
        "status": "processed",
        "trackingNumber": "9407300000000000000004",
        "expectedDeliveryDate": "2026-09-22",
        "mailedAt": "2026-09-07T10:02:11.000Z",
        "testMode": true
      },
      "needsReview": false,
      "error": null,
      "createdAt": "2026-09-07T09:45:00.000Z",
      "updatedAt": "2026-09-07T10:02:11.000Z"
    }
  }
}

{
  "ok": false,
  "error": {
    "code": "letter_already_mailed",
    "message": "This letter has already been mailed."
  }
}

{
  "ok": false,
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key."
  }
}

{
  "ok": false,
  "error": {
    "code": "postage_unavailable",
    "message": "Lob rejected the letter: file must be a PDF with 8.5x11 inch pages."
  }
}

{
  "ok": false,
  "error": {
    "code": "account_disabled",
    "message": "This account is disabled."
  }
}

{
  "ok": false,
  "error": {
    "code": "letter_not_found",
    "message": "Letter not found."
  }
}

{
  "ok": false,
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Try again shortly."
  }
}

{
  "ok": false,
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred."
  }
}

{
  "ok": false,
  "error": {
    "code": "mail_provider_not_configured",
    "message": "Mailing is not configured on this deployment."
  }
}