API Reference

PermitPilot REST API v1

A clean, versioned REST API for programmatic access to projects, conditions, documents and authority workflows. Every response is JSON, every write is idempotent.

Base URL
https://api.permitpilot.io/v1
Auth
Bearer <API_KEY>
Rate limit
600 req / min

Projects

GET
/v1/projects
List all projects for the authenticated tenant.
200 response
[
  { "id": "p1", "name": "Riverside Residences", "status": "in_progress", "progress": 62 }
]
Endpoint is live and responding.
POST
/v1/projects
Create a new construction project.
Request body
{
  "name": "Riverside Residences",
  "city": "Berlin",
  "customer_id": "c1",
  "deadline": "2026-11-30"
}
200 response
{ "id": "p123", "status": "planning" }
Endpoint is live and responding.
GET
/v1/projects/{id}
Fetch a single project with its conditions summary.
Endpoint is live and responding.
PATCH
/v1/projects/{id}
Update fields such as status, deadline or manager.
Endpoint is live and responding.
DELETE
/v1/projects/{id}
Archive or permanently delete a project.
Endpoint is live and responding.