Previous value: -"Pick by what rides on the letter. CERTIFIED_ERR ($15.97 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($12.97) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.21) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there. Whichever you pick, say its price to the person before they open the link."New value: +"Pick by what rides on the letter. CERTIFIED_ERR ($15.97 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($12.97) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.21) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out, CERTIFIED_ERR is used; if the letter reads as such a notice, Piloxa returns CERTIFIED_DEADLINE as recommended_service with its extra cost, without selecting it. Whichever you pick, say its price to the person before they open the link."

Added value: +{
+  "description": "standard_total_cents, discount_cents, payable_total_cents, currency, promotion_status (eligible, not_eligible, depends_on_account, not_applicable), expires_at and approval_routes. Quote payable_total_cents to the person; while promotion_status is depends_on_account the first-letter price is not promised.",
+  "type": [
+    "object",
+    "null"
+  ]
+}

Added value: +{
+  "description": "What the person must do to prove who they are: nothing to preview; verify their email when they send.",
+  "type": "object"
+}

Added value: +{
+  "description": "Binds an approval to this exact document, recipient, sender, service and total until final_quote.expires_at. Pass it to authorize_certified_letter where that is available.",
+  "type": "string"
+}

Previous value: -"The same total, formatted for a person, e.g. \"$16.17\"."New value: +"The same total, formatted for a person, with a dollar sign and cents."

Added value: +{
+  "description": "This letter, for authorize_certified_letter and for follow-up in this conversation.",
+  "type": [
+    "string",
+    "null"
+  ]
+}

Added value: +{
+  "description": "PREPARED while something is still missing; AWAITING_APPROVAL when only the person’s approval and payment are left.",
+  "enum": [
+    "PREPARED",
+    "AWAITING_APPROVAL"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Optional: the date, as YYYY-MM-DD, by which the letter asks the recipient to answer, pay or act. Leave it out and Piloxa reads it from the letter (\"within 30 days of receipt\", \"no later than October 15, 2026\"). The day after that date Piloxa emails the sender, once, with the date USPS delivered the letter and the next step if nobody answered, at no charge.",
+  "type": "string"
+}

Previous value: -"The same as passing service CERTIFIED_EVIDENCE: adds the Evidence Pack to a certified letter with the Electronic Return Receipt. One page is $24.41 in total instead of $16.17."New value: +"The same as passing service CERTIFIED_EVIDENCE: adds the Evidence Pack to a certified letter with the Electronic Return Receipt. One page is $24.21 in total instead of $15.97."

Previous value: -"Pick by what rides on the letter. CERTIFIED_ERR ($16.17 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($13.18) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.41) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there. Whichever you pick, say its price to the person before they open the link."New value: +"Pick by what rides on the letter. CERTIFIED_ERR ($15.97 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($12.97) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.21) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there. Whichever you pick, say its price to the person before they open the link."

Previous value: -"The complete, final letter body exactly as it should print: salutation, paragraphs separated by blank lines, and closing. Do not include the addresses or date; they are laid out from the other fields. Up to 60,000 characters. It must fit in 5 printed pages, about 2,000 words."New value: +"The complete, final letter body exactly as it should print: salutation, paragraphs separated by blank lines, and closing. Do not include the addresses or date; they are laid out from the other fields. Up to 60,000 characters. It must fit in 10 printed pages, about 4,000 words."

Previous value: -"The complete, final letter body exactly as it should print: salutation, paragraphs separated by blank lines, and closing. Do not include the addresses or date; they are laid out from the other fields. Up to 60,000 characters."New value: +"The complete, final letter body exactly as it should print: salutation, paragraphs separated by blank lines, and closing. Do not include the addresses or date; they are laid out from the other fields. Up to 60,000 characters. It must fit in 5 printed pages, about 2,000 words."

Previous value: -"CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back) and is the DEFAULT for an ordinary letter. CERTIFIED is certified mail with tracking but no record of who signed. CERTIFIED_EVIDENCE is the same mailing as CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one. Choose it when the letter is a statutory or contractual notice whose proof may be needed in a dispute later - a pre-lien or preliminary notice, a debt validation notice, a notice to cure, a notice of intent to sue, a proof of loss - and say the price back to the person before they pay. CERTIFIED_DEADLINE ($50.10 for one page) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed: choose it when a missed or refused notice would cost a lien, a contract remedy or a claim. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there."New value: +"Pick by what rides on the letter. CERTIFIED_ERR ($16.17 for one page) is the DEFAULT for an ordinary letter: Certified Mail with the Electronic Return Receipt, the record of who signed, kept when USPS reports it back. CERTIFIED ($13.18) is Certified Mail with tracking but no record of who signed; use it only when the person asks for the cheapest way. CERTIFIED_EVIDENCE ($24.41) is CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one; use it when proof of exactly what was sent may be needed later in a dispute - a debt validation notice, a notice to cure, a proof of loss, a demand before suing. CERTIFIED_DEADLINE ($50.10) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed; use it when a missed or refused notice would cost a lien, a contract remedy or a claim - a pre-lien or preliminary notice, a notice with a statutory deadline. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there. Whichever you pick, say its price to the person before they open the link."

Previous value: -"CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back) and is the DEFAULT: leave this out unless the person has said they do not want the signature record. CERTIFIED is certified mail with tracking but no record of who signed. CERTIFIED_EVIDENCE is the same mailing as CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one. Choose it when the letter is a statutory or contractual notice whose proof may be needed in a dispute later - a pre-lien or preliminary notice, a debt validation notice, a notice to cure, a notice of intent to sue, a proof of loss - and say the price back to the person before they pay."New value: +"CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back) and is the DEFAULT for an ordinary letter. CERTIFIED is certified mail with tracking but no record of who signed. CERTIFIED_EVIDENCE is the same mailing as CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one. Choose it when the letter is a statutory or contractual notice whose proof may be needed in a dispute later - a pre-lien or preliminary notice, a debt validation notice, a notice to cure, a notice of intent to sue, a proof of loss - and say the price back to the person before they pay. CERTIFIED_DEADLINE ($50.10 for one page) is CERTIFIED_EVIDENCE plus a second copy by First-Class Mail the same day and a warning email if the certified copy goes unclaimed: choose it when a missed or refused notice would cost a lien, a contract remedy or a claim. When this field is left out and the letter reads as such a notice, Piloxa selects CERTIFIED_DEADLINE on the review page and says so in its answer; the person can switch it back there."

Previous value: -[
-  "CERTIFIED",
-  "CERTIFIED_ERR",
-  "CERTIFIED_EVIDENCE"
-]New value: +[
+  "CERTIFIED",
+  "CERTIFIED_ERR",
+  "CERTIFIED_EVIDENCE",
+  "CERTIFIED_DEADLINE"
+]

Added value: +{
+  "description": "What in the letter led to that recommendation.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Present when the letter reads as a notice whose miss or refusal would cost a legal right: the service worth mentioning to the person.",
+  "type": "string"
+}

Previous value: -[
-  "CERTIFIED",
-  "CERTIFIED_ERR",
-  "CERTIFIED_EVIDENCE"
-]New value: +[
+  "CERTIFIED",
+  "CERTIFIED_ERR",
+  "CERTIFIED_EVIDENCE",
+  "CERTIFIED_DEADLINE"
+]

Added value: +{
+  "description": "The same as passing service CERTIFIED_EVIDENCE: adds the Evidence Pack to a certified letter with the Electronic Return Receipt. One page is $24.41 in total instead of $16.17.",
+  "type": "boolean"
+}

Previous value: -"CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back) and is the DEFAULT: leave this out unless the person has said they do not want the signature record. CERTIFIED is certified mail with tracking but no record of who signed."New value: +"CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back) and is the DEFAULT: leave this out unless the person has said they do not want the signature record. CERTIFIED is certified mail with tracking but no record of who signed. CERTIFIED_EVIDENCE is the same mailing as CERTIFIED_ERR plus the Evidence Pack: a Certificate of Mailing, and the record kept for 7 years instead of one. Choose it when the letter is a statutory or contractual notice whose proof may be needed in a dispute later - a pre-lien or preliminary notice, a debt validation notice, a notice to cure, a notice of intent to sue, a proof of loss - and say the price back to the person before they pay."

Previous value: -[
-  "CERTIFIED",
-  "CERTIFIED_ERR"
-]New value: +[
+  "CERTIFIED",
+  "CERTIFIED_ERR",
+  "CERTIFIED_EVIDENCE"
+]

Added value: +{
+  "description": "True when the Evidence Pack was bought: a Certificate of Mailing is issued with the record and the record is kept for 7 years rather than one.",
+  "type": "boolean"
+}

Previous value: -[
-  "CERTIFIED",
-  "CERTIFIED_ERR"
-]New value: +[
+  "CERTIFIED",
+  "CERTIFIED_ERR",
+  "CERTIFIED_EVIDENCE"
+]

Previous value: -"CERTIFIED_ERR adds the Electronic Return Receipt (proof of who signed) and is the DEFAULT: leave this out unless the person has said they do not want the signature record. CERTIFIED is certified mail with tracking but no record of who signed."New value: +"CERTIFIED_ERR adds the Electronic Return Receipt (the record of who signed, kept when USPS reports it back) and is the DEFAULT: leave this out unless the person has said they do not want the signature record. CERTIFIED is certified mail with tracking but no record of who signed."

Previous value: -"CERTIFIED_ERR adds the Electronic Return Receipt (proof of who signed)."New value: +"CERTIFIED_ERR adds the Electronic Return Receipt (proof of who signed) and is the DEFAULT: leave this out unless the person has said they do not want the signature record. CERTIFIED is certified mail with tracking but no record of who signed."

Previous value: -"The finished PDF, base64-encoded (standard or URL-safe alphabet), up to 4 MB decoded. Use ONLY when you have read the actual file bytes; a filename or an attachment reference is not a document. Mutually exclusive with letter_text. The file is kept exactly as sent."New value: +"The finished PDF, base64-encoded (standard or URL-safe alphabet), up to 4 MB decoded. Use ONLY when you have read the actual file bytes; a filename or an attachment reference is not a document. Mutually exclusive with letter_text and document_text. The file is kept exactly as sent."

Added value: +{
+  "description": "The COMPLETE text of a document that is already finished, printed exactly as written: no return address, no date line, no \"Re:\" line and no signature block are added, and line breaks and indentation are kept. This is the right field for a document the person gave you, for text you read out of a PDF or an attachment, for a filled-in form or a notice — anything you did not compose as a letter in this conversation. Include every word that must print, the addresses and signature line included if the document carries them. Up to 60,000 characters. Mutually exclusive with letter_text and document_base64.",
+  "type": "string"
+}

Previous value: -"Only when the person already has a finished PDF that you cannot read and they will attach it on the review page themselves. Set true to prepare without letter_text or document_base64."New value: +"Only when the person already has a finished PDF that neither you nor they can give you the text of, and they will attach it on the review page themselves. Set true to prepare without letter_text, document_text or document_base64. Prefer document_text whenever you can read the document at all: it saves the person an upload."

Added value: +{
+  "description": "The recipient exactly as addressed in the letter, one part per line, e.g. \"Acme Property Management LLC\\nAttn: Jane Doe\\n1234 Wilshire Blvd, Suite 500\\nLos Angeles, CA 90017\". Piloxa reads the name, company, street, suite, city, state and ZIP out of it. Use this when you have the address as written and do not want to split it up yourself; any field you also name explicitly wins over it.",
+  "type": "string"
+}

Added value: +{
+  "description": "The sender exactly as it should appear as the return address, one part per line. Read the same way as recipient_address_block. This is where a returned envelope goes back to.",
+  "type": "string"
+}

Previous value: -[
-  "recipient_name"
-]New value: +[]

Added value: +{
+  "description": "Always false: the person needs no account to open the link and read the letter, and none is created by this call.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Which way the document arrived, and so what the person will see on the page.",
+  "enum": [
+    "letter_text",
+    "document_text",
+    "pdf_bytes",
+    "person_will_attach"
+  ],
+  "type": "string"
+}

Previous value: -"True when letter_text was rendered into the PDF the person will review; false otherwise."New value: +"True when letter_text or document_text was laid out into the PDF the person will review; false otherwise."

Added value: +{
+  "description": "The same total, formatted for a person, e.g. \"$16.17\".",
+  "type": "string"
+}

Added value: +{
+  "description": "What is still needed before this can be mailed, in plain words. Empty when nothing is missing. Ask the person for these now.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "True when nothing is missing: the person only has to read it, pay and authorize.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The recipient as Piloxa read it, including anything parsed out of recipient_address_block. Check it against the letter and say it back to the person.",
+  "type": "object"
+}