An invoice in. A case out.

Authentication

Send the key as a bearer token. Keys are per account; create up to five, revoke any time. Use HTTPS only.

Authorization: Bearer mtp_live_…

Create a claim

POST /api/v1/claims — debtor.name, amount (up to 50000), and invoice.dueDate are required. Send sender once, or save a business profile on the receivables page.

curl -X POST https://makethempay.ca/api/v1/claims \
  -H "Authorization: Bearer mtp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "debtor": { "name": "Acme Widgets Ltd.", "kind": "business", "address": "12 King St W, Toronto ON M5H 1A1", "email": "[email protected]" },
    "amount": 4250.00,
    "invoice": { "number": "1042", "date": "2026-06-15", "dueDate": "2026-07-15", "description": "Website build, phase 2" },
    "sender": { "name": "Northwind Inc.", "address": "1 Bay St, Toronto ON M5J 2R8", "email": "[email protected]" }
  }'

{
  "claim": {
    "id": "5b0c…", "ref": "1042", "stage": "asked", "stageLabel": "Asked",
    "amount": 4250, "debtor": "Acme Widgets Ltd.",
    "dates": { "arose": "2026-07-15", "demandSent": "2026-09-08", "demandDue": "2026-09-22" },
    "links": { "self": "…/api/v1/claims/5b0c…", "letter": "…/api/v1/claims/5b0c…/letter", "dashboard": "…/claim" }
  }
}

Read

• GET /api/v1/claims — every claim on the account, newest first.
• GET /api/v1/claims/:id — one claim: stage, dates, amount, links.
• GET /api/v1/claims/:id/letter — the demand letter as PDF.

Stages

owed → asked → built → filed → served → defended or default → conference → trial → judgment → enforcing → paid. Stages derive from dates; the dashboard and the API always agree.

Errors and limits

• 401 unauthorized: missing or revoked key.
• 402 plan_required: the free tier allows 3 cases; the response carries an upgrade link.
• 422 no_sender: send sender once or save a profile.
• Fair use: 60 requests a minute per key. Amounts over $50,000 are refused: Small Claims Court cannot hear them.