How to document a US commercial contract dispute over withheld milestone payments

If a counterparty has withheld one or more milestone payments, the first actions are not legal argument but documentation: identify which law controls (UCC or state contract law), preserve every relevant record immediately, build a concise chronology tied to contract milestones, and send a focused written demand that cites the contract and the amount withheld. Those steps establish the factual record you will need whether you pursue negotiation, arbitration, or litigation.

Why that sequence matters: identifying the governing law tells you which formal rules apply (for example, whether UCC Article 2 governs a sale of goods), preservation protects you from sanctions and preserves discoverable ESI, and a clear demand letter both invites resolution and strengthens your later case by documenting the dispute and putting the other side on notice.

Identify the governing law and the contract’s dispute rules

A practical early question is whether the contract is primarily for goods or for services. If the dispute concerns the sale of goods, Article 2 of the Uniform Commercial Code (UCC) will likely govern key topics such as contract formation and certain formalities; see the UCC Article 2 summary for the governing provisions and the statute-of-frauds rules that may apply. Refer to the UCC text for the controlling principles: U.C.C. — Article 2 (Sales). Use the UCC state-adoption locator to check whether and how your state has adopted Article 2: UCC Locator.

If the contract is for services, or is a mixed contract where services dominate, state common-law contract principles usually control and rules will vary by state. Also check the contract for a choice-of-law clause, forum-selection clause, or mandatory arbitration/mediation provisions—those terms often determine where and how a dispute must be pursued. Knowing the governing law and forum narrows discovery rules, deadlines, and remedies you should prepare for.

Preserve evidence at once — avoid spoliation risk

Once a dispute is reasonably foreseeable (for example, after you raise the withheld payment with the counterparty or prepare a demand), preserve all potentially relevant information. Courts routinely impose sanctions when parties fail to preserve discoverable evidence; ABA guidance explains preservation and includes sample preservation letters you can adapt to put the other side (and your own records custodians) on notice: ABA spoliation primer and sample letter.

What to preserve: contract and amendments; milestone specifications and acceptance criteria; invoices and credit memos; payment records (bank transfers, cancelled checks); emails, texts, and messages in collaboration tools (Slack, project-management systems); change orders and delivery receipts; inspection and acceptance/rejection notices; source files, build artifacts, and relevant metadata (timestamps). Modern communications and social-media content are discoverable in the same way as email — ABA material on managing social media is a helpful reference: Ethics of managing social media content.

Practical preservation steps: instruct IT or records custodians not to delete relevant accounts or logs; take backups or screenshots of ephemeral content; collect original files and metadata; log who handled each piece of evidence and when it was collected. The ABA also offers a practical guide to remedying document-discovery mishaps that explains common pitfalls and remediation steps: Guide to remedying document discovery mishaps.

Build a persuasive evidence bundle and a timeline

Courts and arbitrators respond to clarity. Assemble an evidence bundle that begins with a one-page timeline linking each withheld milestone to documentary proof. The timeline should show: contract date and key provisions, milestone definitions and acceptance criteria, the date work was delivered or milestone achieved, any sign-off or acceptance communications (or lack thereof), invoice date and amount, payment due date, and the date the other party notified you of withholding (and why, if stated).

Organize supporting documents into labeled folders with a simple index: (1) Contract and amendments, (2) Milestone specs and deliverables, (3) Acceptance/inspection records, (4) Invoices and payment records, (5) All communications about payment/dispute, (6) Change orders and scope documents, (7) ESI exports and screenshots, (8) Witness contact list and contemporaneous notes. Metadata (timestamps, file properties) and contemporaneous internal notes markedly increase credibility.

A realistic example: an engineering vendor who met a code-delivery milestone but lacked a client sign-off should attach the build artifacts, the delivery email, timestamped test logs, the invoice, and all follow-up messages. If the client later claims the work failed acceptance testing, contemporaneous test logs and delivery proof help rebut that claim.

Use a focused written demand wisely — and understand its limits

A well-drafted demand letter does three practical things: it summarizes the factual basis (which milestone, what amount), cites the controlling contract provisions, and gives the counterparty a short, reasonable deadline to cure or explain before you escalate. The ABA’s resources on settlement and drafting effective offers explain how to state facts clearly and use a demand to trigger preservation obligations and negotiation: How to draft effective settlement offers.

Attach or reference the key documents (contract excerpt, milestone spec, invoice) and document delivery (email with read receipt, certified mail return receipt). Keep the tone factual: a demand is a procedural step, not a court filing, and it does not by itself establish legal entitlement. If the contract requires arbitration or mediation, the demand should acknowledge and follow those procedures.

What can go wrong and when to seek counsel

Common pitfalls: failing to preserve ESI, sending an inflammatory or legally inaccurate demand that complicates settlement, or proceeding to self-help remedies that the contract forbids. Lawyers have ethical duties to advise clients about preservation and must avoid destroying or hiding evidence; federal rules provide sanction authority for ESI missteps — see the Federal Rules of Civil Procedure for the discovery framework that will apply if the dispute becomes litigation: Federal Rules of Civil Procedure.

Because statutes of limitation, small-claims thresholds, and procedural rules vary by state, get local legal advice before filing suit or exercising contractual self-help. The UCC is enacted by states but with variations; use the UCC locator to confirm your state's adoption: UCC Locator.

Final checklist and next step

Documenting a withheld-milestone dispute is primarily about creating a clear record: (1) confirm whether the UCC or state law applies, (2) preserve all records and ESI immediately, (3) assemble a dated timeline tied to documentary proof, and (4) send a concise written demand that cites the contract and the amount withheld while following any contractually required dispute processes. If you want professional help preparing a clear demand letter from client-supplied facts, note that services exist to draft demand documents for commercial disputes; for example: .

Accurate documentation does not guarantee payment, but it gives you the evidence and procedural footing to resolve the dispute quickly or pursue remedy through the correct forum without avoidable discovery or preservation problems.

For help preparing a professional demand letter, BeforeSuit can help you prepare your next steps.