§ Developer API · v1

Build something with our pricing data.

A small, read-only JSON API. The same data the calculator runs on — exposed cleanly so contractors, comparison tools, or homeowners’ spreadsheets can pull live numbers.

The basics

Base URL — https://us.deckcosttoronto.com
Auth — none. No keys, no signups.
Response — JSON. UTF-8. Always wrapped in { version, data }.
Caching — endpoints set Cache-Control: public, s-maxage=3600. Cache aggressively.
CORS — *. Browser-side calls work without a proxy.
License — CC BY 4.0. Use it commercially, attribute us.deckcosttoronto.com.

Endpoints

GET/api/v1/pricing

All pricing constants — materials, heights, railings, feature add-ons, stairs, demolition, permit fees, and the calculator's input bounds.

Example

curl https://us.deckcosttoronto.com/api/v1/pricing

Response (truncated)

{
  "version": "v1",
  "currency": "USD",
  "taxesIncluded": false,
  "region": "Dallas–Fort Worth metroplex",
  "year": 2026,
  "data": {
    "materials": [
      {
        "id": "pressure_treated",
        "label": "Pressure-treated lumber",
        "perSqFt": { "low": 20, "high": 35 },
        "blurb": "Most affordable. Lasts 15–20 years..."
      },
      ...
    ],
    "heights": [...],
    "railings": [...],
    "features": [...],
    "stairsPerStep": { "low": 130, "high": 250 },
    "demolitionPerSqFt": { "low": 3, "high": 6 },
    "permitCost": { "low": 150, "high": 600 },
    "minProjectFloor": { "low": 3500, "high": 5000 }
  }
}

GET/api/v1/cities

List of all 13 DFW cities the calculator covers. Each entry includes slug, region, population, intro copy, and the local permit note.

Example

curl https://us.deckcosttoronto.com/api/v1/cities

Response (truncated)

{
  "version": "v1",
  "count": 13,
  "data": [
    {
      "slug": "dallas",
      "name": "Dallas",
      "region": "Dallas County",
      "population": 1300000,
      "intro": "Dallas's deck market is the busiest...",
      "permitNote": "Most attached decks...",
      "neighbourhoods": ["Lakewood", "Oak Cliff", ...]
    },
    ...
  ]
}

GET/api/v1/cities/{slug}

Full record for a single city, including local-challenge prose and the sample-build framing used on that city's landing page.

Example

curl https://us.deckcosttoronto.com/api/v1/cities/dallas

Response (truncated)

{
  "version": "v1",
  "data": {
    "slug": "dallas",
    "name": "Dallas",
    "region": "Dallas County",
    "population": 1300000,
    "intro": "...",
    "contextNotes": ["...", "...", "..."],
    "permitNote": "...",
    "neighbourhoods": [...],
    "localChallenge": "...",
    "sampleBuildIntro": "..."
  }
}

Versioning

We’ll keep v1 stable. Breaking changes go to v2 at a new path. Additive changes (new fields) may land in v1 without notice — write your client to ignore unknown keys.

Hit a problem?

Email hello@deckcosttoronto.com. If you’re building something interesting, tell us — we may link to it from /changelog.