MEASURE CENTER

Partner API v1 — roof measurement reports by address. Residential only. Base URL: https://measure.talktotom.ai

Authentication

Every request needs your API key:

Authorization: Bearer nfm_live_xxxxxxxxxxxx

1 · Order a report $5.00

POST /api/v1/reports
{ "address": "4213 Hollow Hill Dr, Tampa, FL 33624" }

Instant response (~1 second) with a squares estimate while the full report builds:

{
  "ok": true,
  "report_id": "e731b156-…",
  "address": "4213 Hollow Hill Dr, Tampa, FL 33624, USA",
  "status": "queued",
  "eta_seconds": 75,
  "instant": { "roof_sqft": 3307, "squares_est": 33.1, "imagery_quality": "HIGH" },
  "poll": "/api/v1/reports/e731b156-…"
}

Residential street addresses only — commercial/POI addresses and oversized roofs return 422 and are not charged. Failed builds are not charged.

2 · Poll for the finished report

GET /api/v1/reports/{report_id}

Poll every 5 seconds; typical build time is 45–90 seconds. When status is done:

{
  "status": "done",
  "measurements": {
    "squares": 33.07, "total_sqft": 3307, "ground_sqft": 3011,
    "facets": 8, "predominant_pitch": "4/12",
    "lengths_ft": { "eave": 192, "rake": 14, "ridge": 61, "hip": 88, "valley": 33, "transition": 24 },
    "pitch_breakdown": [ { "pitch": "4/12", "area_sqft": 2401, "pct": 73 }, … ],
    "segments": [ { "pitch": "4/12", "azimuth": 177, "area_sqft": 851 }, … ]
  },
  "pdf_url": "https://measure.talktotom.ai/api/v1/reports/{id}/pdf",
  "build_seconds": 58
}

GET /api/v1/reports/{id}/pdf returns the full 10-page photo-first PDF report (same key auth).

3 · Homeowner info $1.25

POST /api/v1/homeowner
{ "address": "4213 Hollow Hill Dr, Tampa, FL 33624" }

{
  "ok": true,
  "owner_name": "J. Smith",
  "is_company": false,
  "phones": [ { "number": "(813) 555-0100", "type": "Wireless", "carrier": "…", "is_connected": true } ],
  "emails": [ "…" ]
}

No data found → 404, not charged.

4 · One-tap proposal $1.50

Builds a client-ready, brand-themed 4-page proposal PDF from a finished report:

POST /api/v1/proposals
{
  "address": "4213 Hollow Hill Dr, Tampa, FL 33624, USA",
  "material": "gaf_hdz",          // gaf_hdz · oc_duration · ct_landmark · malarkey_vista · metal · tile
  "rate_per_square": 475,          // your installed $/sq
  "waste_pct": 11                  // optional, default 11
}

{ "ok": true, "proposal_id": "0ac7e09a-…", "pdf_url": "…/api/v1/proposals/{id}/pdf" }

Usage & billing

GET /api/v1/usage

Returns lifetime + current-month totals per product. Billing is monthly on usage.

Product	Price	Notes
Roof measurement report	$5.00	JSON measurements + 10-page PDF, ~60s
Proposal	$1.50	Brand-themed 4-page PDF, needs a report on file
Homeowner info	$1.25	Owner name, phones, emails — not charged on miss

Errors

Code	Meaning
401	Missing/invalid API key
404	Not found (homeowner miss = not charged)
409	Proposal requested before a report exists for that address
422	Non-residential address / no imagery coverage — not charged
429	Daily report limit reached — contact us to raise it

Questions / limits / new products: helpdesk@measurecenter.ai · Measure Center — Powered by Talk to Tom