TruTec API · v1

Build on TruTec

A REST API, webhooks, bulk export and a hosted MCP server for your TruTec workspace. Measure sites from aerial imagery and keep customers, sites, jobs and estimates in sync with your own systems.

View as Markdown

The TruTec API gives your own systems the same data your team sees in the app. Everything is JSON over HTTPS, authenticated with a workspace API key, and versioned under /v1.

Measure a siteSend an address or an outline. Get pavement area, stalls, striping footage, crosswalks and more. Customers, sites & jobsRead and write the customers, sites and jobs in your workspace, and sync them with your own database. Estimates & proposalsLine items, totals, versions and status for every estimate your team builds. Webhooks & eventsGet told when jobs, estimates and invoices change instead of polling. File exportsGet any file the app downloads (proposal PDFs, workbooks, payroll, takeoff maps and KMZ) as a 24-hour link. Bulk data exportDownload your workspace data in bulk, any time, for your warehouse or your records. AI assistants (MCP)Connect ChatGPT, Claude, Cursor, VS Code or any MCP client to your TruTec data.

The basics#


Base URL	`https://trutec.ai/api/v1`
Auth	Your API key in the `X-API-Key` header (Authentication)
Format	JSON request and response bodies, UTF-8. Send `Content-Type: application/json` on `POST` and `PATCH`
Transport	HTTPS only
Versioning	Breaking changes only ship in a new version (Versioning & changes)
Where to call from	Your servers. Keys are secrets and must never ship in browser or mobile code
Machine-readable	OpenAPI 3.1 spec · llms.txt for AI tools

Quick start#

1. Create a key. A workspace owner opens Settings › API keys in TruTec and creates a key. Copy it right away: it is shown once.

2. Check the connection. /v1/health needs no key, so it tells you the API is reachable:

curl https://trutec.ai/api/v1/health

{"status": "ok", "version": "v1"}

3. Make an authenticated call. List the jobs in your workspace:

curl https://trutec.ai/api/v1/jobs \
  -H "X-API-Key: sk_your_api_key_here"

4. Measure a site. Start a measurement from an address, then poll for the result:

curl -X POST https://trutec.ai/api/v1/detect/address \
  -H "X-API-Key: sk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"address": "1200 Commerce Dr, Austin, TX 78701"}'

The full flow, with polling and the result format, is in Measure a site.

What's in the API#

Area	What you can do
Measure a site	AI takeoff from aerial imagery: pavement, stalls, striping, crosswalks, markings
Saved measurements & imagery	Read takeoffs as your team saved them in the app, plus their imagery
Condition ratings	PASER and PCI pavement condition ratings from one image
Customers & sites	Customer companies and the properties you work on
Jobs	Create, read and update jobs, with photos, change orders and proposal maps
Estimates & proposals	Estimates with line items, totals, versions and revisions
Job costing	Costs, labor, invoices and allocation per job
Webhooks & events	Change notifications and a replayable event feed
Bulk data export	Your workspace data in bulk files
AI assistants (MCP)	A hosted MCP server over the same API
Partner API	For software platforms that offer TruTec to their own customers

Help#

Email [email protected] with the endpoint, the time of the call and the response body. Never send your full API key; the first 11 characters (sk_ plus 8) are enough for us to find it. Live uptime is on our status page.