TURNKEYBUILD.AI
TurnkeyBuild.AI
api.turnkeybuild.ai · v1.0 · stable

TurnkeyBuild REST API
Manage projects,
bids & contracts.

A complete REST API to manage the full construction workflow — from user registration and project creation to bid management, milestones, contracts, and transactions.

Interactive API Docs
POST /api/auth/login 200 OK 
// Authenticate and get access token
curl -X POST https://turnkeybuild.ai/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","password":"••••••••"}'
// → 200 OK
{
  "status": true,
  "data": {
    "tokens": {
      "access_token": "eyJhbGci...",
      "token_type": "Bearer",
      "expires_in": 604800
    }
  }
}

Built for developers who ship.

REST endpoints, predictable JSON, Bearer token auth, cursor pagination, and clear error codes. Every endpoint has example request bodies and response schemas.

  • Bearer token authAll protected endpoints require Authorization: Bearer {token} obtained from the login endpoint.
  • Pagination on all list APIsEvery list endpoint supports page, limit, sort_by, and sort_order.
  • OpenAPI 3.0 specMachine-readable YAML spec available — generate clients in any language using standard tooling.
  • Role-based accessGeneral Contractor, Material Provider, and Subcontractor — each with scoped endpoint access.
  • Stripe payment integrationProject creation includes a Stripe Checkout session flow. Projects activate only after successful payment confirmation via webhook.
Open Interactive Docs
POST /api/projects/create 200 OK 
# Create a new project
        curl -X POST https://turnkeybuild.ai/api/projects/create \
        -H "Authorization: Bearer $TOKEN" \
        -F "project_name=Maple Ridge SFR" \
        -F "lot_number=1001" \
        -F "location=123 Main St, Austin TX" \
        -F "pincodes=78701" \
        -F "category_ids=2,13" \
        -F "project_documents=@./plans.pdf"

      # → 200 OK
      {
        "status": true,
        "message": "Project created successfully",
        "data": {
          "project_id": 525
        }
      }

From bid portals to full project pipelines.

The TurnkeyBuild API was designed to support the complete construction workflow — here's what teams are building on top of it.

01

Supplier & Subcontractor Portals

Build private bid portals where material providers submit quotations and subcontractors accept scopes of work. The API handles matching, roles, and milestones.

02

Project Management Integrations

Sync TurnkeyBuild projects, bids, and bid status into your PM tools. Pull project lists and details programmatically to drive downstream workflows.

03

Contract & Signature Workflows

Automate contract generation, signature collection from all three parties (GC, Supplier, Subcontractor), and contract status tracking for every project category.

04

Finance & Transaction Dashboards

Pull transaction history and invoice download links into your accounting or BI stack. Track payments per project and generate financial reports programmatically.

Call the API from anything.

Use the OpenAPI 3.0 spec to auto-generate a client in your language of choice, or call the REST endpoints directly with any HTTP library.

JS
JavaScript
TS
TypeScript
Py
Python
Go
Go
PHP
PHP
cURL
cURL

See TurnkeyBuild in action.

Book a 30-minute walkthrough with our team. We'll show you the full API, answer your integration questions, and get you set up with sandbox access.

  • Live API walkthroughSee every endpoint in action with real data from a live environment.
  • Integration consultationOur engineers will help you map your workflow to the right API endpoints.
  • Sandbox access includedLeave the call with API keys and a working test environment ready to go.

Book your demo

We typically respond within business day.

Start building with the TurnkeyBuild API.

Explore the full interactive documentation, try every endpoint live, and have a working integration running today.

Open Interactive Docs Back to TurnkeyBuild.AI