# Bill-The-Job — full manifest

> Bill-The-Job is billing and project software that helps contractors run their business — fast estimates, one-tap invoicing, labor and materials tracking, and an AI assistant — and connects them with their clients and suppliers.

## For Contractors

- https://billthejobs.com/
  category: product
  priority: 1
  changefreq: weekly
  summary: Bill-The-Job landing page — estimates, invoicing, labor tracking, and the Dash AI assistant for contractors.
- https://billthejobs.com/pricing/
  category: product
  priority: 0.9
  changefreq: weekly
  summary: Plans and pricing — free tier and paid tiers with AI receipt extraction and unlimited documents.
- https://billthejobs.com/tools/estimate-builder/
  category: tool
  priority: 0.9
  changefreq: monthly
  summary: Free contractor estimate builder/generator — add sections and line items, see totals, and download a PDF. No account required; save it with a free account to send it.
- https://billthejobs.com/tools/invoice-generator/
  category: tool
  priority: 0.9
  changefreq: monthly
  summary: Free contractor invoice generator — add line items, contractor fee, and tax, see totals, and download an invoice PDF. No account required; save it with a free account to send it and track payment.
- https://billthejobs.com/contractors/
  category: product
  priority: 0.8
  changefreq: weekly
  summary: Contractor hub — trade-specific solutions and guides for running a contracting business.
- https://billthejobs.com/contractors/for/general-contractors/
  category: use-case
  priority: 0.7
  changefreq: monthly
  summary: General Contractors: Bill-The-Job is general contractor billing software: build multi-section estimates, bill in stages with progress billing, and track subcontractor labor by job — while an AI assistant drafts the paperwork. GCs get paid faster.
- https://billthejobs.com/contractors/for/roofers/
  category: use-case
  priority: 0.7
  changefreq: monthly
  summary: Roofing Contractors: Bill-The-Job is roofing estimate software: price a roof fast, handle roofing material markup the way you price it, snap a supplier receipt into line items, and invoice with a deposit. Roofers get paid faster.
- https://billthejobs.com/contractors/learn/how-to-write-an-estimate/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: A practical, step-by-step guide to writing a contractor estimate that wins the job and protects your margin — scope, line items, materials markup, labor, taxes, and terms.
- https://billthejobs.com/contractors/learn/free-estimate-template/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: A free contractor estimate template you can copy — plus what every estimate must include and a free builder that does the math and exports a PDF for you.
- https://billthejobs.com/contractors/learn/phased-project-estimating/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: A practical guide to breaking a large construction job into phases — splitting scope, budget, and timeline across stages so you can bid clearly, bill progressively, and protect cash flow.
- https://billthejobs.com/contractors/learn/subcontractor-invoices-guide/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: Learn how to manage, verify, and reconcile subcontractor invoices, track project costs, and streamline subcontractor billing using manual vs. digital C2C workflows.
- https://billthejobs.com/contractors/learn/bilingual-invoicing/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: A practical guide for US contractors who work across English and Spanish: how to write an estimate in one language and send a professional invoice in your client's, without errors in the numbers.
- https://billthejobs.com/contractors/learn/how-to-estimate-roofing/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: A step-by-step guide to estimating a roofing job: measure roof squares, add waste, quantify shingles and underlayment, price tear-off and labor, and protect your margin.
- https://billthejobs.com/contractors/learn/how-to-estimate-painting/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: How to estimate a painting job: measure wall and ceiling square footage, figure coats and paint coverage, price prep and labor, and mark up materials to protect your margin.
- https://billthejobs.com/contractors/learn/how-to-estimate-concrete/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: How to estimate a concrete job: measure area and thickness, convert to cubic yards with waste, price base, rebar, forms, and finish labor, and protect your margin.
- https://billthejobs.com/contractors/learn/how-to-estimate-drywall/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: How to estimate a drywall job: measure wall and ceiling area, count sheets, quantify compound and tape, price hanging and finishing by level, and protect your margin.
- https://billthejobs.com/contractors/learn/how-to-estimate-electrical/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: How to estimate an electrical job: count devices and circuits with the unit method, build the materials list, price rough-in and trim labor, add permits, and protect your margin.
- https://billthejobs.com/contractors/learn/how-to-estimate-plumbing/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: How to estimate a plumbing job: count fixtures and runs, build the materials list, price rough-in and fixture-set labor, add permits and inspection, and protect your margin.
- https://billthejobs.com/contractors/learn/how-to-estimate-hvac/
  category: learn
  priority: 0.6
  changefreq: monthly
  summary: How to estimate an HVAC job: size the system from the load, price equipment and the ductwork or line set, add install and startup labor, cover permits, and protect your margin.

## General

- https://billthejobs.com/privacy/
  category: legal
  priority: 0.3
  changefreq: yearly
  summary: Privacy policy.
- https://billthejobs.com/terms/
  category: legal
  priority: 0.3
  changefreq: yearly
  summary: Terms of service.
- https://billthejobs.com/security/
  category: legal
  priority: 0.3
  changefreq: yearly
  summary: Security & encryption policy.

## For AI agents: build a contractor estimate

Build a contractor estimate for a user with no account, API key, or PII. Totals are computed server-side with exact decimal math (line totals, contractor fee, discount, sales tax, grand total).

### Estimate spec (shared by the deep-link payload and the REST body)

- business_name (string, optional): The contractor's business name (shown on the estimate).
- client_name (string, optional): The client/customer name.
- title (string, optional): Estimate title, e.g. 'Kitchen Remodel'.
- fee_mode ("none" | "integrated" | "explicit", optional): Contractor fee: none, folded into prices (integrated), or a separate line (explicit). Default none.
- fee_percent (number string, optional): Contractor fee percent, e.g. '15' for 15%. Default 0.
- tax_rate (number string (fraction), optional): Sales tax as a fraction, e.g. '0.0875' for 8.75%. Default 0.
- discount_type ("none" | "percent" | "amount", optional): Optional document discount. Default none.
- discount_value (number string, optional): Discount percent or dollar amount, per discount_type. Default 0.
- sections (Section[], required): Array of { title, line_items: [{ description, quantity, unit?, unit_price }] }. Quantities/prices are number strings.

Example:
```json
{
  "business_name": "Acme Builders",
  "client_name": "Jane Doe",
  "title": "Deck Rebuild",
  "fee_mode": "integrated",
  "fee_percent": "10",
  "tax_rate": "0.0875",
  "sections": [
    {
      "title": "Framing",
      "line_items": [
        {
          "description": "Pressure-treated lumber",
          "quantity": "2",
          "unit_price": "100"
        },
        {
          "description": "Labor",
          "quantity": "8",
          "unit": "hr",
          "unit_price": "55"
        }
      ]
    }
  ]
}
```

### Option 1 — Deep-link (no API call, works anywhere) — recommended
https://billthejobs.com/tools/estimate-builder?d=<URL-encoded JSON estimate spec>
Easiest path, no API call: build the JSON estimate spec (fields below), URL-encode it, and put it in the `d` query parameter. Give the user the resulting link — they land on a prefilled estimate builder with totals already calculated, and can download a PDF or save it with a free account. Plain JSON only; do NOT base64-encode.

Worked example (this exact link prefills the builder):
https://billthejobs.com/tools/estimate-builder?d=%7B%22business_name%22%3A%22Acme%20Builders%22%2C%22client_name%22%3A%22Jane%20Doe%22%2C%22title%22%3A%22Deck%20Rebuild%22%2C%22fee_mode%22%3A%22integrated%22%2C%22fee_percent%22%3A%2210%22%2C%22tax_rate%22%3A%220.0875%22%2C%22sections%22%3A%5B%7B%22title%22%3A%22Framing%22%2C%22line_items%22%3A%5B%7B%22description%22%3A%22Pressure-treated%20lumber%22%2C%22quantity%22%3A%222%22%2C%22unit_price%22%3A%22100%22%7D%2C%7B%22description%22%3A%22Labor%22%2C%22quantity%22%3A%228%22%2C%22unit%22%3A%22hr%22%2C%22unit_price%22%3A%2255%22%7D%5D%7D%5D%7D

### Option 2 — REST endpoint (server-side)
POST https://billthejobs.com/api/v1/public/estimates  (auth: none)
Build a contractor estimate. Totals (line totals, contractor fee, discount, tax, grand total) are computed server-side with exact decimal math. Returns a token, a public link, and a watermarked PDF URL. No account, no API key, no PII required. Rate-limited per IP.
Response: {"token":"<opaque-token>","pdf_path":"/api/v1/public/estimates/<token>/pdf","view":"{ business_name, client_name, title, sections, subtotal, fee_amount, tax_amount, total, ... }"}
Public link: https://billthejobs.com/e/<token>  ·  Watermarked PDF: https://billthejobs.com/api/v1/public/estimates/<token>/pdf
The figures are the ones supplied; this is an estimate preview, not a binding quote. The visitor can download a watermarked PDF and create a free account (no credit card) to send a clean, branded version.

Machine-readable manifest: https://billthejobs.com/.well-known/ai-capabilities.json

## Trust & security

- Security: Client PII (names, emails, addresses, phone numbers) and document text (notes, terms) are encrypted at rest with AES-256-GCM using per-organization keys.
- Privacy: We do not sell or rent your personal information.
- Free tier: Free plan with no credit card required — build unlimited estimates and invoices per project, AI receipt-photo extraction, and labor tracking.
- Security policy: https://billthejobs.com/security/
- Privacy policy: https://billthejobs.com/privacy/
- Terms: https://billthejobs.com/terms/